Khắc phục sự cố & Câu hỏi thường gặp về Android và Firebase
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này cung cấp các mẹo và thông tin khắc phục sự cố đối với những vấn đề cụ thể về Android mà bạn có thể gặp phải khi sử dụng Firebase.
Bạn gặp phải những thách thức khác hoặc không thấy vấn đề của mình được nêu bên dưới? Hãy nhớ xem Câu hỏi thường gặp chính về Firebase để biết thêm câu hỏi thường gặp chung về Firebase hoặc câu hỏi thường gặp dành riêng cho sản phẩm.
Bạn cũng có thể xem kho lưu trữ GitHub của Firebase Android SDK để biết danh sách mới nhất về các vấn đề đã báo cáo và cách khắc phục sự cố. Bạn cũng nên gửi các vấn đề liên quan đến Firebase Android SDK của riêng mình tại đó!
Tôi gặp lỗi cho biết thư viện ktx không phân giải được hoặc không tìm thấy.
Lỗi này có thể là do bạn đang sử dụng Firebase BoM và chỉ định một mô-đun KTX làm phần phụ thuộc thư viện sản phẩm.
Vào tháng 7 năm 2025, chúng tôi ngừng phát hành các phiên bản mới của mô-đun KTX và xoá các thư viện KTX khỏi Firebase Android BoM (v34.0.0).
Nếu bạn sử dụng API KTX từ các mô-đun KTX đã phát hành trước đó, thì bạn nên di chuyển ứng dụng để sử dụng API KTX từ các mô-đun chính thay thế. Để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này.
Làm cách nào để khắc phục lỗi "Đã có một ứng dụng OAuth2 cho tên gói và SHA-1 này trong một dự án khác"?
Lỗi này xảy ra nếu chúng tôi phát hiện thấy một dự án Firebase hoặc Google Cloud khác chứa mã ứng dụng OAuth 2.0 có tên gói và SHA-1 mà bạn đã chỉ định. Tìm hiểu cách giải quyết lỗi này.
Khi thêm Firebase vào dự án Android, tôi gặp lỗi "Không tìm thấy".
Lỗi này thường có nghĩa là ứng dụng của bạn thiếu một hoặc nhiều tham chiếu đến kho lưu trữ Maven của Google. Nhớ thêm kho lưu trữ Maven của Google (google()) vào tệp Cấu hình Gradle.
- Nếu dự án của bạn đang sử dụng cú pháp
plugins, hãy thêm cú pháp đó vào phần plugins trong tệp settings.gradle.kts hoặc settings.gradle.
- Nếu dự án của bạn đang sử dụng cú pháp
buildscript, hãy thêm cú pháp này vào cả hai mục buildscript và allprojects trong tệp build.gradle.kts hoặc build.gradle cấp dự án.
Khi thêm một Firebase SDK vào dự án Android, tôi gặp lỗi về tính năng hỗ trợ invoke-custom và việc bật tính năng khử đường.
Vào tháng 5 năm 2021 (Firebase BoM phiên bản 28.0.0), Firebase đã tắt tính năng khử đường cú pháp cho tất cả các thư viện Android của mình (xem ghi chú phát hành).
Thay đổi này có nghĩa là các bản dựng Gradle sử dụng trình bổ trợ Android cho Gradle (AGP) phiên bản 4.2 trở về trước cần bật tính năng hỗ trợ Java 8. Nếu không, khi thêm một SDK Firebase, các dự án Android này sẽ gặp lỗi sau đây khi tạo:
D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
compileOptions {
sourceCompatibility 1.8
targetCompatibility 1.8
}
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.
Để khắc phục lỗi này, bạn có thể làm theo một trong hai cách sau:
- Thêm
compileOptions được liệt kê trong thông báo lỗi vào tệp build.gradle.kts hoặc build.gradle cấp ứng dụng.
- Tăng
minSdkVersion cho dự án Android của bạn lên 26 trở lên.
Tính năng Đăng nhập bằng Google đang hiển thị lỗi "12500:" sau khi tôi phát hành ứng dụng. Làm cách nào để khắc phục lỗi này?
Có 2 lý do có thể khiến điều này xảy ra: bạn chưa cung cấp email hỗ trợ hoặc bạn thiếu khoá SHA. Để khắc phục lỗi này, hãy đảm bảo tất cả các điều kiện sau đều được đáp ứng:
Làm cách nào để thêm trình bổ trợ Firebase vào một dự án Android bằng cú pháp buildscript?
Firebase có các trình bổ trợ Gradle sau:
| Tên trình bổ trợ |
Toạ độ Maven |
Phiên bản mới nhất |
Mã nhận dạng trình bổ trợ |
| Trình bổ trợ Dịch vụ Google Play |
com.google.gms:google-services |
4.4.3 |
com.google.gms.google-services |
| App Distribution plugin |
com.google.firebase:firebase-appdistribution-gradle |
5.1.1 |
com.google.firebase.appdistribution |
| Crashlytics plugin |
com.google.firebase:firebase-crashlytics-gradle |
3.0.5 |
com.google.firebase.crashlytics |
| Performance Monitoring plugin |
com.google.firebase:perf-plugin |
2.0.0 |
com.google.firebase.firebase-perf |
Sau đây là cách thêm một trình bổ trợ Firebase vào một dự án Android vẫn sử dụng cú pháp buildscript:
Trong tệp Gradle cấp gốc (cấp dự án) (<project>/build.gradle.kts hoặc <project>/build.gradle), hãy thêm trình bổ trợ làm phần phụ thuộc bằng cách sử dụng toạ độ Maven của trình bổ trợ:
Kotlin
buildscript {
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
dependencies {
...
// Add the Maven coordinates and latest version of the plugin
classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
}
}
allprojects {
...
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
}
Groovy
buildscript {
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
dependencies {
...
// Add the Maven coordinates and latest version of the plugin
classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
}
}
allprojects {
...
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
}
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thêm trình bổ trợ bằng mã nhận dạng trình bổ trợ:
Kotlin
plugins {
id("com.android.application")
// Add the ID of the plugin
id("FIREBASE_PLUGIN_ID")
...
}
Groovy
plugins {
id 'com.android.application'
// Add the ID of the plugin
id 'FIREBASE_PLUGIN_ID'
...
}
