Android Developer Roadmap: Các Yếu tố Thiết yếu của Firebase: Authentication, Firestore, và Crashlytics

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.

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. GoogleSignInClient không còn là đường chính thức; dùng Credential Manager để lấy ID token rồi đổi sang GoogleAuthProvider credential.
  • 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ớp uid trên path, query luôn nằm trong phạm vi một user.
  • Collection phẳng orders/{orderId} với field ownerId. 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êm whereEqualTo("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.json khô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, awaitClose và đườ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; setUserId dù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.