Từ chỗ trì hoãn suốt nhiều tháng đến lúc chuyển xong 182k người dùng: đây là cách cuối cùng tôi cũng đưa app của mình sang Supabase.
Chuyển 182.000 người dùng sang một backend mới không phải chuyện nhỏ, nhất là khi bạn là một lập trình viên mobile làm một mình và vẫn đang đi làm toàn thời gian. Nhưng tôi đã làm được. Tôi đã chuyển app của mình, OSM Tactics, từ một hệ thống NestJS + MongoDB rối rắm sang Supabase, cái tên đang được bàn tán nhiều nhất trong giới backend hiện nay. Trong bài này, tôi sẽ kể lại cả hành trình: vì sao tôi chọn Supabase, những khó khăn tôi gặp phải, và tôi đã thực hiện việc migration ra sao.
Vì sao chọn Supabase?
Khi backend của app bắt đầu có cảm giác cũ kỹ, tôi tìm thứ gì đó tốt hơn, và Supabase lọt vào mắt tôi. Nó là một dự án mã nguồn mở, kiểu giống Firebase nhưng dễ bắt đầu hơn. Nó cho bạn một database PostgreSQL với API dễ dùng, tính năng real-time và tính năng đăng nhập được dựng sẵn hết. Với tôi, một người chuyên làm app mobile, như vậy là hoàn hảo: tôi không muốn vật lộn với mấy thứ server phức tạp. Bạn có thể dựng xong một project Supabase trong khoảng năm phút, và tài liệu thì cực kỳ dễ hiểu, nên tôi không thấy lạc lối dù không phải dân backend chuyên nghiệp.
Nhưng Supabase không chỉ dễ dùng, nó còn đang lớn mạnh. Nó chưa lớn bằng Firebase, nhưng rất nhiều lập trình viên đang dùng nó và cộng đồng đang phát triển nhanh. Nó có mọi thứ tôi cần: database để lưu dữ liệu, công cụ đăng nhập, chỗ để upload file, và cả những function nhỏ có thể chạy mà không cần cả một server. Firebase giấu cách nó hoạt động, còn Supabase dùng PostgreSQL, một database lâu đời, đáng tin cậy mà rất nhiều người tin dùng. Điều đó có nghĩa là tôi có thể thay đổi mọi thứ theo ý mình và mở rộng sau này mà không bị mắc kẹt. Thêm nữa, có cả một cộng đồng lập trình viên lớn trên mạng chia sẻ mẹo, thủ thuật và cách sửa lỗi ở những nơi như GitHub. Tôi biết nếu bị kẹt, tôi có thể Google hoặc hỏi ai đó. Với một người code một mình và thiếu thời gian như tôi, Supabase có vẻ là lựa chọn đúng: nó đơn giản nhưng đủ mạnh để gánh app của tôi.
Hệ thống cũ trước cuộc chuyển đổi lớn

Trước khi nói về việc nhảy sang Supabase, hãy nói về thứ tôi đang dùng. App của tôi, OSM Tactics, là một game mobile cho Android và iOS, nơi mọi người lên kế hoạch chiến thuật (khá hay nếu bạn thích mấy thứ này). Backend là thứ tôi tự xây bằng NestJS, một framework cho Node.js mà tôi thích vì nó dùng được với TypeScript và giữ mọi thứ ngăn nắp. Nó kết nối với MongoDB, database nơi tôi lưu toàn bộ thông tin người dùng, dữ liệu game và những thứ khác. Tôi đã chạy hệ thống này gần bốn năm.
_Ảnh chụp mới nhất của mongodb trước khi migration, Osm Tactics hay còn gọi là “Osm Guide” _
Nhưng vấn đề là thế này: tôi chỉ có một mình và còn một công việc toàn thời gian, và việc giữ cho backend này sống đang vắt kiệt tôi. Lúc đầu, NestJS và MongoDB vẫn ổn, tôi xoay xở được. Nhưng khi có thêm nhiều người dùng, mọi thứ trở nên lộn xộn. Tôi phải bỏ ra quá nhiều thời gian để đảm bảo server không sập, vá các lỗ hổng bảo mật và giữ cho nó đủ nhanh. Bảo mật là phần tệ nhất: tôi biết chút Node.js, nhưng tôi là dân làm app mobile, không phải chuyên gia backend. Nó vẫn chạy, tạm được, nhưng giống như một chiếc xe cũ cứ hỏng liên tục. Tôi không thể vá víu nó mãi được. Tôi cần thứ gì đó mới, thứ không khiến tôi muốn bứt tóc.
Bước nhảy: quyết định migration

Quyết định chuyển toàn bộ không hề nhanh chóng. Nó mất rất lâu vì tôi cứ trì hoãn mãi. OSM Tactics không phải một app khổng lồ với hàng tấn tính năng, nhưng 182k người dùng là một lượng dữ liệu lớn phải xử lý. Chuyển từ MongoDB, nơi dữ liệu lỏng lẻo và tự do, sang PostgreSQL của Supabase, nơi mọi thứ nằm trong các bảng gọn gàng, nghe có vẻ khó. Tôi sẽ phải làm lại cách tổ chức dữ liệu và đảm bảo không làm mất gì quan trọng. Bộ đôi NestJS và MongoDB cũ vẫn đang chạy, nhưng tôi có linh cảm xấu là nó sẽ sớm nổ tung. Nỗi lo đó cứ bám lấy tôi cho đến khi cuối cùng tôi nói: “Được rồi, làm thôi.”
Khi đã quyết định, tôi phải lên kế hoạch thật kỹ. Tôi ngồi xuống và tính cách biến dữ liệu MongoDB thành các bảng Supabase, giống như vẽ một bản đồ xem mọi thứ sẽ đi đâu. Bước một là lấy toàn bộ dữ liệu ra khỏi MongoDB một cách an toàn, nên tôi viết một script nhỏ để dump nó ra các file JSON. Đây là đoạn code đó, khá cơ bản nhưng làm được việc:
async function exportCollection(collectionName, outputFileName, query = {}) {
try {
await mongoose.connect(mongoURI);
const Model = mongoose.model(
collectionName,
genericSchema,
collectionName.toLowerCase()
);
const documents = await Model.find(query).lean();
const outputPath = path.join(__dirname, outputFileName);
fs.writeFileSync(outputPath, JSON.stringify(documents, null, 2));
await mongoose.disconnect();
return documents;
} catch (error) {
if (mongoose.connection.readyState !== 0) {
await mongoose.disconnect();
}
}
}
Script này kết nối với MongoDB, kéo toàn bộ dữ liệu ra và lưu thành các file JSON trên máy tôi. Nó giống như một bản backup: tôi có thể thử nghiệm thoải mái mà không mất hết mọi thứ nếu lỡ làm hỏng. Tôi chạy nó cho từng collection, kiểm tra các file để chắc chắn chúng trông đúng, và thấy yên tâm hơn một chút khi biết mình có bản sao. Dù vậy, tôi vẫn lề mề mãi mới bắt tay vào việc thật: tôi nhìn chằm chằm vào màn hình, nhấp một ngụm cà phê và nghĩ, “Có lẽ để mai.” Phải cố gắng lắm tôi mới thôi lười biếng mà thật sự bắt tay vào làm, nhưng khi đã bắt đầu thì tôi dồn hết sức.
Migration người dùng: bài toán mật khẩu
Đây là lúc mọi chuyện thật sự rắc rối: chuyển 182k người dùng mà vẫn giữ mật khẩu của họ hoạt động. Người dùng mong rằng sau khi tôi cập nhật app, họ vẫn đăng nhập được bằng email và mật khẩu cũ, và đúng là phải như vậy. Nhưng làm được điều đó là cả một cơn ác mộng. Điểm hay là gì? Supabase dùng bcrypt cho mật khẩu, giống như MongoDB, nên tôi không phải làm lại toàn bộ mật khẩu hay bắt người dùng chọn mật khẩu mới. Nếu phải làm vậy thì trải nghiệm sẽ rất tệ: mọi người ghét phải đặt lại mật khẩu, và tôi sẽ mất kha khá người dùng.
Đối phó với bảng auth khó tính của Supabase
Supabase có bảng auth.users cho việc đăng nhập, và nó cực kỳ khắt khe. Nó có cả đống trường mà bạn phải điền đúng chuẩn, nếu không là nó “phát điên”: ví dụ nếu bạn để chuỗi rỗng thay vì null, nó sẽ lỗi. Tôi thấy một số lỗi mà người khác gặp phải trong thread GitHub này, và nó làm tôi sợ đến mức phải làm thật cẩn thận. Tôi phải khớp nó một cách hoàn hảo. Đây là hình dạng một người dùng đối với Supabase (tôi không dùng gì liên quan đến số điện thoại nên các trường đó là null, hãy đổi lại nếu bạn có dùng):
const supabaseUser = {
id: uid,
email: user.email,
encrypted_password: user.password || null,
instance_id: "00000000–0000–0000–0000–000000000000",
aud: "authenticated",
role: "authenticated",
email_confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
created_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
updated_at: user.updatedAt ? new Date(user.updatedAt).toISOString() : null,
last_sign_in_at: null,
phone: user.phone || null,
phone_confirmed_at: null,
confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
invited_at: null,
confirmation_token: "",
confirmation_sent_at: null,
recovery_token: "",
recovery_sent_at: null,
email_change_token_new: "",
email_change: "",
email_change_sent_at: null,
email_change_token_current: "",
email_change_confirm_status: 0,
banned_until: null,
reauthentication_token: "",
reauthentication_sent_at: null,
is_super_admin: null,
phone_change: "",
phone_change_token: "",
phone_change_sent_at: null,
is_sso_user: false,
deleted_at: null,
is_anonymous: false,
raw_user_meta_data: JSON.stringify(rawUserMetaData),
raw_app_meta_data: JSON.stringify(rawAppMetaData),
};
Tôi phải điền đúng từng trường một, nếu không Supabase sẽ không chấp nhận. Để chuyển toàn bộ người dùng MongoDB, tôi viết một script lớn hơn để lấy họ ra, chuyển sang định dạng này và lưu thành file CSV. Đây là script đó, hơi dài nhưng thể hiện toàn bộ quy trình:
const fs = require("fs");
const path = require("path");
const { parse } = require("json2csv");
const { v4: uuidv4 } = require("uuid");
const mongoose = require("mongoose");
const mongoURI = "your-connection-string";
// Define a generic schema for flexible document structure
const userSchema = new mongoose.Schema({}, { strict: false });
async function fetchUsersFromMongoDB() {
try {
console.log("Connecting to MongoDB…");
await mongoose.connect(mongoURI);
console.log("Connected to MongoDB");
const UserModel = mongoose.model("Users", userSchema, "users");
console.log("Fetching users from MongoDB…");
const users = await UserModel.find({}).lean();
console.log(`Found ${users.length} users in MongoDB`);
await mongoose.disconnect();
console.log("Disconnected from MongoDB");
return users;
} catch (error) {
console.error("Error fetching users from MongoDB:", error);
if (mongoose.connection.readyState !== 0) {
await mongoose.disconnect();
}
throw error;
}
}
async function processUsers() {
console.time("Total processing time");
const mongoUsersFilePath = path.join(__dirname, "mongo_users.json");
try {
// Step 1: Fetch users from MongoDB
const users = await fetchUsersFromMongoDB();
// Step 2: Write users to a fresh JSON file
fs.writeFileSync(mongoUsersFilePath, JSON.stringify(users, null, 2));
console.log(`Fresh users data written to: ${mongoUsersFilePath}`);
// Step 3: Read the fresh users file
const usersData = JSON.parse(fs.readFileSync(mongoUsersFilePath, "utf8"));
console.log(`Read ${usersData.length} users from fresh file`);
// Step 4: Filter users to include only those with an email or at least one provider
const filteredUsers = usersData.filter((user) => {
return user.email || user.googleId || user.appleId;
});
console.log(`Filtered users: ${filteredUsers.length}`);
// Create a Set to track used IDs and ensure uniqueness
const usedIds = new Set();
const usedEmails = new Set();
const duplicateEmails = [];
// Step 5: Transform the data to match Supabase Auth users structure
const transformedUsers = [];
filteredUsers.forEach((user) => {
if (!user.email) {
console.log("Skipping user without email:", user._id);
return;
}
// Check for duplicate email
const lowerEmail = user.email.toLowerCase();
if (usedEmails.has(lowerEmail)) {
duplicateEmails.push({
email: user.email,
id: user._id,
googleId: user.googleId,
appleId: user.appleId,
});
console.warn(`Duplicate email detected and skipped: ${user.email}`);
return;
}
// Mark this email as used
usedEmails.add(lowerEmail);
let uid = uuidv4();
while (usedIds.has(uid)) {
console.warn("Duplicate ID detected:", uid);
uid = uuidv4();
}
usedIds.add(uid);
const rawUserMetaData = {
sub: uid,
email: user.email,
email_verified: true,
phone_verified: false,
};
const providers = [];
// Check for Google ID
if (user.googleId) {
providers.push("google");
rawUserMetaData.iss = "https://accounts.google.com";
rawUserMetaData.sub = user.googleId;
rawUserMetaData.provider_id = user.googleId;
}
// Check for Apple ID
if (user.appleId) {
providers.push("apple"); // Only override iss and sub if Google wasn't already set
if (!user.googleId) {
rawUserMetaData.iss = "https://appleid.apple.com";
rawUserMetaData.sub = user.appleId;
rawUserMetaData.provider_id = user.appleId;
}
}
// If no external providers, use email
if (providers.length === 0) {
providers.push("email");
}
// Set the raw app metadata
const rawAppMetaData = {
provider: providers[0], // Primary provider is the first one
providers: providers, // All providers in an array
};
transformedUsers.push({
id: uid,
email: user.email || null,
encrypted_password: user.password,
instance_id: "00000000–0000–0000–0000–000000000000",
aud: "authenticated",
role: "authenticated",
invited_at: null,
confirmation_token: "",
confirmation_sent_at: null,
recovery_token: "",
recovery_sent_at: null,
email_change_token_new: "",
email_change: "",
email_change_sent_at: null,
last_sign_in_at: new Date().toISOString(),
is_super_admin: null,
phone: "",
phone_confirmed_at: null,
phone_change: "",
phone_change_token: "",
phone_change_sent_at: null,
confirmed_at: new Date().toISOString(),
email_change_token_current: "",
email_change_confirm_status: 0,
banned_until: null,
reauthentication_token: "",
reauthentication_sent_at: null,
is_sso_user: false,
deleted_at: null,
is_anonymous: false,
created_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
updated_at: null,
email_confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
phone: user.phone || null,
phone_confirmed_at: null,
raw_user_meta_data: rawUserMetaData,
raw_app_meta_data: rawAppMetaData,
});
});
// Step 6: Convert the transformed data to CSV
const csvFields = [
"id",
"email",
"encrypted_password",
"instance_id",
"aud",
"role",
"email_confirmed_at",
"invited_at",
"confirmation_token",
"confirmation_sent_at",
"recovery_token",
"recovery_sent_at",
"email_change_token_new",
"email_change",
"email_change_sent_at",
"last_sign_in_at",
"raw_app_meta_data",
"raw_user_meta_data",
"is_super_admin",
"created_at",
"updated_at",
"phone",
"phone_confirmed_at",
"phone_change",
"phone_change_token",
"phone_change_sent_at",
"confirmed_at",
"email_change_token_current",
"email_change_confirm_status",
"banned_until",
"reauthentication_token",
"reauthentication_sent_at",
"is_sso_user",
"deleted_at",
"is_anonymous",
];
// Write duplicate emails to a file for reference
if (duplicateEmails.length > 0) {
fs.writeFileSync(
path.join(__dirname, "duplicate_emails.json"),
JSON.stringify(duplicateEmails, null, 2)
);
console.log("Duplicate emails written to duplicate_emails.json");
}
const csv = parse(transformedUsers, { fields: csvFields });
// Step 7: Write the CSV to a file
const csvFilePath = path.join(__dirname, "supabase_users.csv");
fs.writeFileSync(csvFilePath, csv);
console.log("CSV file has been generated:", csvFilePath);
// Step 8: Delete the temporary fresh users file
if (fs.existsSync(mongoUsersFilePath)) {
fs.unlinkSync(mongoUsersFilePath);
console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
}
console.timeEnd("Total processing time");
} catch (error) {
console.error("Error processing users:", error);
} finally {
if (fs.existsSync(mongoUsersFilePath)) {
try {
fs.unlinkSync(mongoUsersFilePath);
console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
} catch (deleteError) {
console.error(`Error deleting temporary file: ${deleteError.message}`);
}
}
}
}
Sau khi có file CSV, tôi tạo một bảng giả trong Supabase giống hệt auth.users. Cấu trúc của bảng thật là một đoạn SQL dài mà bạn có thể xem trong editor của Supabase, ở mục schema auth > users > Definition:
create table auth.users (
instance_id uuid null,
id uuid not null,
aud character varying(255) null,
role character varying(255) null,
email character varying(255) null,
encrypted_password character varying(255) null,
email_confirmed_at timestamp with time zone null,
invited_at timestamp with time zone null,
confirmation_token character varying(255) null,
confirmation_sent_at timestamp with time zone null,
recovery_token character varying(255) null,
recovery_sent_at timestamp with time zone null,
email_change_token_new character varying(255) null,
email_change character varying(255) null,
email_change_sent_at timestamp with time zone null,
last_sign_in_at timestamp with time zone null,
raw_app_meta_data jsonb null,
raw_user_meta_data jsonb null,
is_super_admin boolean null,
created_at timestamp with time zone null,
updated_at timestamp with time zone null,
phone text null default null::character varying,
phone_confirmed_at timestamp with time zone null,
phone_change text null default ''::character varying,
phone_change_token character varying(255) null default ''::character varying,
phone_change_sent_at timestamp with time zone null,
confirmed_at timestamp with time zone GENERATED ALWAYS as (LEAST(email_confirmed_at, phone_confirmed_at)) STORED null,
email_change_token_current character varying(255) null default ''::character varying,
email_change_confirm_status smallint null default 0,
banned_until timestamp with time zone null,
reauthentication_token character varying(255) null default ''::character varying,
reauthentication_sent_at timestamp with time zone null,
is_sso_user boolean not null default false,
deleted_at timestamp with time zone null,
is_anonymous boolean not null default false,
constraint users_pkey primary key (id),
constraint unique_email unique (email),
constraint users_phone_key unique (phone),
constraint users_email_change_confirm_status_check check (
(
(email_change_confirm_status >= 0)
and (email_change_confirm_status <= 2)
)
)
) TABLESPACE pg_default;
create unique INDEX IF not exists confirmation_token_idx on auth.users using btree (confirmation_token) TABLESPACE pg_default
where
((confirmation_token)::text !~ '^[0-9 ]*$'::text);
create unique INDEX IF not exists email_change_token_current_idx on auth.users using btree (email_change_token_current) TABLESPACE pg_default
where
(
(email_change_token_current)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists email_change_token_new_idx on auth.users using btree (email_change_token_new) TABLESPACE pg_default
where
(
(email_change_token_new)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists reauthentication_token_idx on auth.users using btree (reauthentication_token) TABLESPACE pg_default
where
(
(reauthentication_token)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists recovery_token_idx on auth.users using btree (recovery_token) TABLESPACE pg_default
where
((recovery_token)::text !~ '^[0-9 ]*$'::text);
create unique INDEX IF not exists users_email_partial_key on auth.users using btree (email) TABLESPACE pg_default
where
(is_sso_user = false);
create index IF not exists users_instance_id_email_idx on auth.users using btree (instance_id, lower((email)::text)) TABLESPACE pg_default;
create index IF not exists users_instance_id_idx on auth.users using btree (instance_id) TABLESPACE pg_default;
create index IF not exists users_is_anonymous_idx on auth.users using btree (is_anonymous) TABLESPACE pg_default;
Tôi sao chép cấu trúc đó cho bảng tạm của mình, upload file CSV vào, rồi dùng script này để chuyển người dùng sang bảng auth.users thật, mỗi lần một nghìn người:
DO $$
DECLARE
batch_size INT := 1000; -- Adjust batch size as needed
records_inserted INT;
BEGIN
LOOP
INSERT INTO auth.users (
id,
email,
encrypted_password,
instance_id,
aud,
role,
email_confirmed_at,
invited_at,
confirmation_token,
confirmation_sent_at,
recovery_token,
recovery_sent_at,
email_change_token_new,
email_change,
email_change_sent_at,
last_sign_in_at,
raw_app_meta_data,
raw_user_meta_data,
is_super_admin,
created_at,
updated_at,
phone,
phone_confirmed_at,
phone_change,
phone_change_token,
phone_change_sent_at,
email_change_token_current,
email_change_confirm_status,
banned_until,
reauthentication_token,
reauthentication_sent_at,
is_sso_user,
deleted_at,
is_anonymous
)
SELECT
id,
email,
encrypted_password,
COALESCE(instance_id, '00000000-0000-0000-0000-000000000000'),
COALESCE(aud, 'authenticated'),
COALESCE(NULLIF(role, ''), 'authenticated'),
COALESCE(email_confirmed_at, NOW()),
COALESCE(invited_at, NULL),
COALESCE(confirmation_token, ''),
COALESCE(confirmation_sent_at, NULL),
COALESCE(recovery_token, ''),
COALESCE(recovery_sent_at, NULL),
COALESCE(email_change_token_new, ''),
COALESCE(email_change, ''),
COALESCE(email_change_sent_at, NULL),
COALESCE(last_sign_in_at, NOW()),
raw_app_meta_data, -- Use value from test_users table
raw_user_meta_data, -- Use value from test_users table
COALESCE(is_super_admin, NULL),
COALESCE(created_at, NOW()),
COALESCE(updated_at, NOW()),
COALESCE(phone, NULL),
COALESCE(phone_confirmed_at, NULL),
COALESCE(phone_change, ''),
COALESCE(phone_change_token, ''),
COALESCE(phone_change_sent_at, NULL),
COALESCE(email_change_token_current, ''),
COALESCE(email_change_confirm_status, 0),
COALESCE(banned_until, NULL),
COALESCE(reauthentication_token, ''),
COALESCE(reauthentication_sent_at, NULL),
COALESCE(is_sso_user, false),
COALESCE(deleted_at, NULL),
COALESCE(is_anonymous, false)
FROM public.test_users
LIMIT batch_size
ON CONFLICT (email) DO NOTHING; -- Ignore duplicates
GET DIAGNOSTICS records_inserted = ROW_COUNT;
-- Exit the loop if no more records are inserted
IF records_inserted = 0 THEN
EXIT;
END IF;
END LOOP;
END $$;
Bằng cách này, tôi thấy được từng bước: export, biến đổi, nạp dữ liệu. Nó mất nhiều thời gian hơn so với dùng một công cụ xịn xò nào đó, nhưng tôi thích việc biết chính xác điều gì đang diễn ra. Tôi kiểm tra bảng tạm sau khi nạp CSV, kiểm tra ngẫu nhiên vài dòng, rồi theo dõi script chạy theo batch để chắc chắn nó không bị nghẽn.
Không có chỗ cho trường tùy chỉnh
Bảng auth.users của Supabase không cho bạn thêm trường của riêng mình, điều này làm tôi bất ngờ. Ở MongoDB, tôi chỉ cần nhét thêm một trường username vào là xong. Nhưng Supabase nói không: bạn chỉ được dùng những gì nó cung cấp. Tôi đã nghĩ đến việc nhét dữ liệu thêm vào raw_user_meta_data, thứ giống như một cái túi JSON, nhưng như vậy sẽ rất lộn xộn khi cần tìm kiếm sau này. Thay vào đó, tôi tạo một bảng profiles mới, liên kết với auth.users qua ID người dùng. Nó chứa những thứ như username và locale, giữ mọi thứ gọn gàng.
Bạn cũng có thể xem thảo luận này, có thể sẽ hữu ích: https://github.com/orgs/supabase/discussions/3491
Thiết lập phần này đồng nghĩa với thêm việc: tôi phải lấy các trường bổ sung đó từ MongoDB, ghép chúng với đúng người dùng và nạp vào bảng mới. Tôi viết thêm một script khác để lấy dữ liệu đó, chuyển thành CSV và upload lên Supabase sau khi xong phần auth. Giờ cách tổ chức này tốt hơn vì tôi có thể thêm trường sau này mà không làm hỏng gì, nhưng nó khiến việc migration lâu hơn vì tôi phải xử lý hai bảng thay vì một.
Migration đăng nhập Google/Apple

Đăng nhập bằng Google và Apple cũng là một cực hình. Trong MongoDB, tôi có các trường googleId và appleId, và một số người dùng có cả hai gắn với cùng một email. Supabase xử lý chuyện này bằng các trường đặc biệt trong raw_user_meta_data như iss, sub và provider_id.
Đây là cách tôi thiết lập:
const uid = uuidv4();
const providers = [];
// Build raw user metadata
const rawUserMetaData = {
sub: uid,
email: user.email,
email_verified: true,
phone_verified: false,
};
// Check for Google ID
if (user.googleId) {
providers.push("google");
rawUserMetaData.iss = "https://accounts.google.com";
rawUserMetaData.sub = user.googleId;
rawUserMetaData.provider_id = user.googleId;
}
// Check for Apple ID
if (user.appleId) {
providers.push("apple");
if (!user.googleId) {
rawUserMetaData.iss = "https://appleid.apple.com";
rawUserMetaData.sub = user.appleId;
rawUserMetaData.provider_id = user.appleId;
}
}
// If no external providers, use email
if (providers.length === 0) {
providers.push("email");
}
Trong app, tôi cập nhật các luồng đăng nhập để dùng API của Supabase. Với Apple:
import * as AppleAuthentication from "expo-apple-authentication";
import { supabase } from "your-supabase-client";
const credential = await AppleAuthentication.signInAsync({
requestedScopes: [
AppleAuthentication.AppleAuthenticationScope.FULL_NAME,
AppleAuthentication.AppleAuthenticationScope.EMAIL,
],
});
if (credential.identityToken) {
const { data, error } = await supabase.auth.signInWithIdToken({
provider: "apple",
token: credential.identityToken,
});
}
Và với Google:
import { GoogleSignin } from "@react-native-google-signin/google-signin";
import { supabase } from "your-supabase-client";
const googleUser = await GoogleSignin.signIn();
if (googleUser.idToken) {
const { data, error } = await supabase.auth.signInWithIdToken({
provider: "google",
token: googleUser.idToken,
});
}
Nó chạy được, nhưng xử lý những người dùng có cả Google lẫn Apple khá khó: tôi phải chọn một cái làm ID chính và liệt kê cái còn lại như phụ. Tôi đã test nó rất nhiều lần trong app để chắc chắn không ai bị khóa ngoài tài khoản.
Lưu ý: Các vấn đề có thể gặp khi export CSV trong Supabase Tính đến hôm nay (29/03/2025), việc export dữ liệu bảng dưới dạng CSV có thể không ổn định, nên hãy nhớ điều này khi so sánh dữ liệu giữa Supabase và nguồn dữ liệu gốc của bạn.
Generate type TypeScript
Supabase có một chiêu rất hay là tự tạo type TypeScript cho bạn. Bạn chạy một lệnh, và nó xuất ra các file cho code của bạn biết chính xác database trông như thế nào. Với app React Native và Expo của tôi, điều đó cực kỳ đáng giá: tôi không phải đoán dữ liệu mình sẽ nhận được hay tự viết type. Nó giảm bug đáng kể vì TypeScript sẽ la lên nếu tôi viết sai. Trước đây, tôi mất hàng giờ sửa những lỗi ngớ ngẩn; giờ thì nhanh hơn nhiều.
Tôi chạy lệnh đó sau khi thiết lập xong các bảng, lấy file type và gắn vào app. Bỗng nhiên, những thứ như user.email hay profile.username cứ thế chạy, không còn phải băn khoăn mình có viết đúng chính tả không. Chỉ là một chuyện nhỏ, nhưng nó khiến việc code app bớt giống trò đoán mò và giống một chiến thắng hơn.
Để database function làm việc
Supabase cho phép bạn viết các function SQL nhỏ chạy ngay trong database, cực kỳ tiện. Thay vì viết cả đống code phía app để thay đổi dữ liệu, tôi để database xử lý.
Đây là một function tôi viết để cộng credit vào profile của người dùng:
declare
current_credits int;
new_credits int;
begin
-- Get current credits from user_profiles table
select assistant_credits
into current_credits
from public.user_profiles
where public.user_profiles.user_id = increase_assistant_credits.user_id;
if current_credits is null then
current_credits := 0;
end if;
new_credits := current_credits + credits_to_add;
-- Update assistant_credits in user_profiles table
update public.user_profiles
set assistant_credits = new_credits
where public.user_profiles.user_id = increase_assistant_credits.user_id;
return new_credits;
end;
Nó lấy số credit của người dùng, cộng thêm, rồi lưu lại, tất cả trong một lần. Nếu không có nó, tôi sẽ phải lấy credit về, cộng trong app rồi gửi ngược lên, tức là nhiều code hơn và nhiều cơ hội làm sai hơn. Tôi cũng viết thêm vài function như vậy cho các tác vụ khác, và nó khiến app có cảm giác nhanh nhạy hơn vì database đã gánh phần việc nặng.
Lưu ý về backend
Có một điểm bất ngờ: Supabase không loại bỏ hoàn toàn backend của tôi. Để dùng một số tính năng đăng nhập dành cho admin, bạn cần service_role key, nhưng bạn không thể đặt nó trong app vì như vậy không an toàn. Vì thế, tôi giữ lại một server NestJS nhỏ để xử lý những việc cần giữ bí mật đó. Nó không lớn như trước, nhưng vẫn ở đó để giữ mọi thứ an toàn. Supabase làm phần lớn công việc, nên mọi thứ vẫn dễ hơn nhiều so với hệ thống cũ của tôi.
Kết luận: xứng đáng với mọi vất vả

Chuyển 182.000 người dùng sang Supabase không chỉ là một thử thách kỹ thuật mà còn là một thử thách tinh thần. Giữa những lần trì hoãn, những đêm thức khuya và vô số lần nghi ngờ bản thân, có những lúc tôi thật sự nghĩ mình sắp làm hỏng mọi thứ. Đó là một quá trình chậm chạp, đầy căng thẳng và do dự. Nhưng việc bỏ lại hệ thống NestJS + MongoDB mong manh để chuyển sang một thứ gọn gàng và dễ bảo trì hơn là hoàn toàn xứng đáng.
Supabase cho tôi sự đơn giản, linh hoạt và sự hỗ trợ từ cộng đồng mà tôi cần, khi là một lập trình viên làm một mình và vẫn đi làm toàn thời gian. Nếu bạn đang nghĩ đến việc migration backend cho app của mình, hãy biết rằng điều đó hoàn toàn làm được. Nó sẽ không nhanh hay nhẹ nhàng, nhưng với một chút kế hoạch (và có lẽ vài đêm thức khuya), bạn sẽ vượt qua và có được một hệ thống mà bạn thật sự tin tưởng.