Ba dịch vụ Firebase trong bài — Authentication, Firestore và Crashlytics — thường được thêm vào app trong một buổi chiều và gây ra vấn đề trong nhiều tháng. Không phải vì API khó, mà vì cách hiểu sai: coi Firestore như backend riêng đáng tin, coi security rules là phần bật sau, coi Crashlytics là thứ chỉ cần thêm dependency.
Đường đi của ba thành phần này ngắn hơn bạn tưởng. Code chạy với compileSdk 36, targetSdk 36, Kotlin 2.4.21, minSdk 24. Version Firebase BoM không ghim ở đây vì bài nói về hành vi SDK; lấy bản hiện hành từ trang setup chính thức.
Mục lục
Cập nhật 2026
- Target API 36 là bắt buộc. Từ 31/08/2026, app mới và bản cập nhật phải target API 36, gia hạn tối đa tới 01/11/2026. Firebase không đổi API, nhưng luồng đăng nhập phải đúng dưới edge-to-edge và notification permission mới.
- Google Sign-In SDK cũ đã deprecated.
GoogleSignInClientkhông còn là đường chính thức; dùng Credential Manager để lấy ID token rồi đổi sangGoogleAuthProvidercredential. - Artifact
-ktxđã ngừng cập nhật. Kotlin extension gộp vào artifact chính, nên dependency làfirebase-auth,firebase-firestore,firebase-crashlytics. - Firebase là một project Google Cloud. Region Firestore chọn một lần lúc tạo project và không đổi được — với dữ liệu cá nhân, đây là quyết định compliance.
Ba thành phần, một đường đi
Một request trong app Firebase đi qua rất ít tầng:
Người dùng → Credential Manager / email + password → Firebase Auth
│
ID token (uid, claims)
│
Firestore SDK (tự gắn token) → Security Rules → dữ liệu của uid đó
│
lỗi runtime → Crashlytics (non-fatal)
Auth không gọi Firestore. SDK Firestore tự gắn token của user đang đăng nhập vào mỗi request; rules là nơi duy nhất kiểm tra request.auth.uid. Crashlytics hứng lỗi từ mọi tầng, không nằm trên đường đi dữ liệu.
Hệ quả: khi bạn đăng xuất, listener Firestore đang mở nhận PERMISSION_DENIED ở lần đọc sau, vì SDK không còn token. Đó là rules làm đúng việc của nó.
Firebase Authentication: UID là gốc của mọi thứ
Authentication giải quyết ba việc: xác minh danh tính, giữ phiên, phát token. Bạn không phải lưu mật khẩu hay tự làm refresh token. Thứ bạn cần là một uid ổn định — khoá trong Firestore, ID trong Crashlytics, chủ thể trong rules.
Đăng nhập email/mật khẩu bằng coroutines
API Task của Play Services nối sang coroutines bằng await() từ kotlinx-coroutines-play-services, không cần callback lồng nhau:
// File: auth/AuthRepository.kt
class AuthRepository(
private val auth: FirebaseAuth = FirebaseAuth.getInstance()
) {
val currentUid: String? get() = auth.currentUser?.uid
suspend fun signIn(email: String, password: String): String {
val result = auth.signInWithEmailAndPassword(email.trim(), password).await()
return result.user?.uid ?: error("Không lấy được uid")
}
fun signOut() = auth.signOut()
}
// File: auth/AuthViewModel.kt
fun signIn(email: String, password: String) = viewModelScope.launch {
_state.value = AuthState.Loading
try {
repo.signIn(email, password)
_state.value = AuthState.SignedIn
} catch (e: FirebaseAuthException) {
_state.value = AuthState.Error(errorMessage(e))
}
}
private fun errorMessage(e: FirebaseAuthException): String = when (e.errorCode) {
"ERROR_INVALID_CREDENTIAL", "ERROR_USER_NOT_FOUND" -> "Email hoặc mật khẩu không đúng"
"ERROR_TOO_MANY_REQUESTS" -> "Thử lại sau ít phút"
"ERROR_NETWORK_REQUEST_FAILED" -> "Kiểm tra kết nối mạng"
else -> "Không đăng nhập được"
}
Ba chi tiết đáng chú ý: ERROR_INVALID_CREDENTIAL và ERROR_USER_NOT_FOUND phải trả cùng một thông báo, nếu không bạn cho người lạ biết email nào đã đăng ký; bắt exception ở ViewModel; và auth.currentUser vẫn khác null sau khi mở lại app.
Google Sign-In: Credential Manager, không phải SDK cũ
Luồng đúng là xin ID token từ Credential Manager rồi đổi thành Firebase credential:
// File: auth/GoogleSignIn.kt — gọi từ Activity/Fragment
suspend fun signInWithGoogle(context: Context, auth: FirebaseAuth) {
val manager = CredentialManager.create(context)
val request = GetCredentialRequest.Builder()
.addCredentialOption(
GetGoogleIdOption.Builder()
.setServerClientId(context.getString(R.string.default_web_client_id))
.setFilterByAuthorizedAccounts(false)
.build()
)
.build()
val credential = try {
manager.getCredential(context, request).credential
} catch (e: NoCredentialException) {
return // người dùng chưa từng đăng nhập Google trên máy này
}
val idToken = GoogleIdTokenCredential.createFrom(credential.data).idToken
auth.signInWithCredential(GoogleAuthProvider.getCredential(idToken, null)).await()
}
serverClientId là OAuth client ID loại Web — default_web_client_id do plugin google-services sinh ra — không phải Android client ID. Bắt thêm GetCredentialCancellationException khi người dùng đóng sheet. SDK cũ vẫn chạy ở nhiều app nhưng không còn được cập nhật, và sẽ cản trở khi bạn thêm passkey.
Firestore: dữ liệu thuộc về ai
Firestore lưu document trong collection; document là map field và có thể chứa subcollection. Câu hỏi thiết kế không phải “đặt ở collection nào” mà là “ai được đọc nó”:
users/{uid}cho profile vàusers/{uid}/orders/{orderId}cho dữ liệu riêng. Rules chỉ cần so khớpuidtrên path, query luôn nằm trong phạm vi một user.- Collection phẳng
orders/{orderId}với fieldownerId. Linh hoạt khi cần truy vấn chung, nhưng rules phải kiểm tra field và mọi query phải thêmwhereEqualTo("ownerId", uid)— rules không lọc hộ bạn.
Một query thật: snapshot listener + coroutines
// File: data/OrderRepository.kt
@IgnoreExtraProperties
data class Order(
val ownerId: String = "",
val total: Long = 0,
val status: String = "",
val createdAt: Timestamp? = null
)
class OrderRepository(
private val db: FirebaseFirestore = FirebaseFirestore.getInstance()
) {
suspend fun profile(uid: String): Map<String, Any>? =
db.collection("users").document(uid).get().await().data
fun myOrders(uid: String): Flow<List<Order>> = callbackFlow {
val registration = db.collection("users").document(uid)
.collection("orders")
.orderBy("createdAt", Query.Direction.DESCENDING)
.limit(50)
.addSnapshotListener { snapshot, error ->
if (error != null) {
close(error)
return@addSnapshotListener
}
trySend(snapshot?.toObjects(Order::class.java).orEmpty())
}
awaitClose { registration.remove() }
}
}
callbackFlow biến listener thành Flow; awaitClose bảo đảm listener bị remove khi collector dừng — ViewModel clear, màn hình đóng, hoặc user đăng xuất. limit(50) không phải chi tiết làm đẹp: mỗi document là một lần đọc tính tiền.
Với thao tác một lần, dùng get().await(). Cần phân biệt cache và server thì đọc snapshot.metadata.isFromCache — nhưng cache có thể cũ hàng tuần.
Security Rules: biên giới thật sự
Rules chạy trên server và kiểm tra mọi đọc ghi; client không sửa được rules, không giả được uid. Đây là thứ duy nhất khiến gọi Firestore trực tiếp từ app là chấp nhận được:
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
function signedIn() {
return request.auth != null;
}
match /users/{uid} {
allow read: if signedIn() && request.auth.uid == uid;
allow update: if signedIn() && request.auth.uid == uid
&& request.resource.data.keys().hasOnly(
['displayName', 'avatarUrl', 'updatedAt'])
&& request.resource.data.displayName is string
&& request.resource.data.displayName.size() <= 80;
}
match /users/{uid}/orders/{orderId} {
allow read: if signedIn() && request.auth.uid == uid;
allow create: if signedIn() && request.auth.uid == uid
&& request.resource.data.total is number
&& request.resource.data.total >= 0;
}
}
}
Rules không lọc dữ liệu thay cho query, không gọi API ngoài, không chạy logic phức tạp. Vì vậy kiểm tra cả kiểu và kích thước field, không chỉ uid — nếu không, một user có thể ghi document vài MB toàn field rác. Role nên nằm trong custom claims (request.auth.token.admin), gán bằng Admin SDK ở backend, không dùng field mà client tự sửa được.
Offline, transaction và batch
Trên Android, persistence bật mặc định: đọc trả từ cache khi mất mạng, ghi vào hàng đợi và đẩy lên khi có mạng. Đừng tắt để “cho nhẹ máy” — bạn sẽ phải viết lại phần khó nhất của SDK.
Nhưng offline có giá: hai thiết bị sửa cùng document thì last-write-wins, không merge. Dùng FieldValue.serverTimestamp() thay System.currentTimeMillis() vì đồng hồ máy có thể lệch.
Với nghiệp vụ cần nhất quán — trừ điểm, đổi trạng thái đơn — dùng runTransaction: SDK tự retry khi document bị sửa giữa hai bước, nên đừng đặt side effect bên trong. Transaction cần mạng; batch xếp hàng được nhưng tối đa 500 thao tác và không đọc được dữ liệu.
Index và denormalization
Firestore tự tạo index cho một field; truy vấn kết hợp equality field này với orderBy field khác cần composite index. Thiếu index, SDK ném FAILED_PRECONDITION kèm link tạo index trong Logcat. Lỗi chỉ xuất hiện khi query chạy thật, nên test trên emulator trước khi phát hành.
NoSQL không có join. Cách đúng là denormalize: copy field cần hiển thị (tên, avatar) vào document con để một lần đọc là đủ, và đồng bộ khi nguồn đổi bằng Cloud Functions, transaction hoặc batch. Không có đường đồng bộ thì đừng copy.
Crashlytics: biết app hỏng trước khi người dùng báo
Crashlytics bắt crash và non-fatal, gom nhóm theo stack trace, gửi báo cáo ở lần mở app kế tiếp. Đừng thay Timber bằng Crashlytics: Timber cho log cục bộ, Crashlytics cho ngữ cảnh gắn với lỗi.
Setup tối thiểu
// File: app/build.gradle.kts — BoM thêm trước khối này, version lấy từ trang setup chính thức
plugins {
id("com.google.gms.google-services")
id("com.google.firebase.crashlytics")
}
android {
compileSdk = 36
defaultConfig { minSdk = 24; targetSdk = 36 }
buildTypes {
release {
isMinifyEnabled = true
}
}
}
dependencies {
implementation("com.google.firebase:firebase-auth")
implementation("com.google.firebase:firebase-firestore")
implementation("com.google.firebase:firebase-crashlytics")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-play-services")
implementation("androidx.credentials:credentials")
implementation("androidx.credentials:credentials-play-services-auth")
}
Plugin google-services đọc google-services.json; plugin crashlytics lo upload mapping. Thiếu plugin thứ hai, crash vẫn được báo nhưng stack trace đã obfuscate thì vô nghĩa.
Custom keys, log và non-fatal
// File: telemetry/CrashReporter.kt
class CrashReporter(
private val crashlytics: FirebaseCrashlytics = FirebaseCrashlytics.getInstance()
) {
fun bindUser(uid: String, tier: String) {
crashlytics.setUserId(uid) // UID nội bộ, không phải email
crashlytics.setCustomKey("tier", tier) // giá trị ngắn, ổn định
}
fun trackScreen(screen: String) {
crashlytics.setCustomKey("last_screen", screen)
crashlytics.log("Mở màn hình $screen")
}
fun reportNonFatal(e: Throwable) {
crashlytics.recordException(e) // non-fatal, app không sập
}
}
Quy tắc đặt key: tên field ổn định, value là enum, boolean hoặc số — không phải chuỗi tự do chứa dữ liệu người dùng. setUserId nhận UID hoặc ID nội bộ; email, số điện thoại, token không được đặt ở đây. recordException dành cho lỗi đã bắt cần thấy trên dashboard (JSON hỏng, HTTP 500), không dành cho lỗi nghiệp vụ như sai mật khẩu — dashboard sẽ ngập.
log() giữ ring buffer message gần nhất, chỉ đọc được khi có báo cáo; không phải nơi lưu log dài hạn.
R8, mapping và deobfuscation
Release build nên bật R8. Đừng tắt minify để stack trace dễ đọc: bạn mất shrink và obfuscation, APK to hơn, mà vẫn không giải quyết gì nếu mapping không được upload. Plugin Crashlytics upload mapping trong release build và deobfuscate trên console — bạn đọc stack trace bằng tên class, hàm gốc.
Nếu app có NDK, bật nativeSymbolUploadEnabled. Tắt mappingFileUploadEnabled để build nhanh thì bạn nhận stack trace a.b.c và mất nhiều thời gian hơn phần tiết kiệm. Giữ -keepattributes SourceFile,LineNumberTable; Gson, Moshi, Retrofit cần keep riêng. Đừng thêm -keep class ** { *; }: nó làm R8 vô dụng và che mất lỗi thật.
Bảo mật: client không bao giờ là biên giới
Mọi thứ trong APK đều có thể đọc, giải mã và sửa. Kẻ tấn công lấy được ID token có thể gọi thẳng REST API của Firestore, bỏ qua toàn bộ validate trong app. Vì vậy:
- Rules là biên giới duy nhất. Validate trong app chỉ là UX; kiểm tra lại uid, kiểu và kích thước field trong rules.
- Không ship admin credentials. Service account JSON, private key, Admin SDK không bao giờ nằm trong APK — Admin SDK bỏ qua rules hoàn toàn.
- API key trong
google-services.jsonkhông phải bí mật. Nó chỉ định danh project; bảo vệ dữ liệu đến từ rules và App Check. - Bật App Check. Play Integrity provider ở release, debug provider ở máy dev; bật monitor trước, đọc số liệu rồi mới enforce.
- Kiểm tra email đã verify cho thao tác nhạy cảm và dùng custom claims cho role; sau khi đổi role gọi
getIdToken(true).
Firebase chạy trên Google Cloud, và project Firebase chính là project Cloud; region Firestore chọn lúc tạo project, ảnh hưởng trực tiếp đến nơi dữ liệu nằm. Nếu app có người dùng tại Việt Nam, đối chiếu với Nghị định 13/2023/NĐ-CP và biểu mẫu data safety của Play. App có tài khoản phải có đường xoá tài khoản; user.delete() yêu cầu đăng nhập gần đây, nên thiết kế re-auth trước.
Những cái bẫy hay gặp
| Bẫy | Hậu quả | Cách sửa |
|---|---|---|
| Validate chỉ ở client | Dữ liệu rác, field không kiểm soát | Kiểm tra kiểu và kích thước trong rules |
| Listener không giới hạn, không remove | Hoá đơn đọc tăng, rò rỉ bộ nhớ | limit() + awaitClose |
| Thiếu composite index | FAILED_PRECONDITION lúc chạy thật |
Tạo index, test query trên emulator |
| Ghi offline đè lên nhau | Mất dữ liệu, last-write-wins | Server timestamp, transaction, UI merge |
| Log PII vào Crashlytics | Vi phạm quyền riêng tư | UID ẩn danh, không email hay token |
| Crashlytics chưa init hoặc thiếu mapping | Không thấy báo cáo, stack vô nghĩa | Kiểm tra plugin, mapping upload |
| Dùng Google Sign-In SDK cũ | Deprecated, thiếu tính năng mới | Credential Manager + ID token |
| Tin API key là bí mật | Cảm giác bảo mật giả | Rules + App Check |
Checklist trước khi phát hành
- Rules đã được test bằng emulator suite, gồm cả trường hợp user A đọc dữ liệu user B.
- Mọi listener đều có
limit,awaitClosevà đường huỷ khi đăng xuất. - Release build bật R8 và mapping đã upload; đã thử đọc một stack trace đã deobfuscate.
- App Check đang ở chế độ phù hợp; debug token không nằm trong bản release.
- Crashlytics không nhận email, token hay nội dung tin nhắn;
setUserIddùng ID nội bộ. - Đã xác nhận region Firestore và có luồng xoá tài khoản đúng yêu cầu của Play.
Đọc tiếp
Ba thành phần này là nền của mọi app Firebase. Khi cần đẩy cấu hình và thông báo mà không phát hành bản mới, đọc Remote Config và Firebase Cloud Messaging. Khi cần backend riêng thay vì BaaS, bài Retrofit và OkHttp là bước tiếp theo. Và nếu đang đặt các bài này vào đúng vị trí, xem lại lộ trình học lập trình viên Android.



