Android 和 Firebase 的故障排除和常见问题解答

本页面针对您在使用 Firebase 时可能遇到的特定于 Android 的问题提供提示和故障排除。

有其他挑战或没有看到您的问题概述如下？请务必查看主要的 Firebase 常见问题解答，了解更多泛 Firebase 或产品特定的常见问题解答。

您还可以查看Firebase Android SDK GitHub 存储库以获取报告的问题和故障排除的最新列表。我们鼓励您也在那里提交您自己的 Firebase Android SDK 相关问题！

将 Android 应用添加到 Firebase 项目时是否需要提供 SHA-1？

Firebase 身份验证（使用Google 登录或电话号码登录时）和Firebase 动态链接需要SHA-1 信息。如果您不使用这些功能，则不必提供 SHA-1。

如何解决此错误：“另一个项目中已存在此包名称和 SHA-1 的 OAuth2 客户端”？

如果我们检测到另一个 Firebase 或 Google Cloud 项目包含具有您指定的包名称和 SHA-1 的 OAuth 2.0 客户端 ID，则会发生此错误。了解如何解决此错误。

当我将 Firebase 添加到我的 Android 项目时，我收到“找不到”错误。

此错误通常意味着您的应用缺少对 Google 的 Maven 存储库的一个或多个引用。在您的项目级build.gradle文件中，确保在您的buildscript和allprojects部分中包含 Google 的 Maven 存储库 ( google() )。

当我将 Firebase SDK 添加到我的 Android 项目时，我收到关于调用自定义支持和启用脱糖的错误。

2021 年 5 月（Firebase BoM v28.0.0），Firebase 禁用了所有 Android 库的脱糖功能（请参阅发行说明）。

此更改意味着使用 Android Gradle 插件 (AGP) v4.2 或更早版本的 Gradle 构建需要启用 Java 8 支持。否则，在添加 Firebase SDK 时，这些 Android 项目会出现以下构建失败：

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.

要修复此构建失败，您可以遵循以下两个选项之一：

• 将错误消息中列出的compileOptions添加到您的应用程序级build.gradle文件中。
• 将您的 Android 项目的minSdkVersion增加到 26 或更高。

在我发布我的应用程序后，Google 登录显示错误“12500：”。我如何解决它？

发生这种情况有两个可能的原因：您没有提供支持电子邮件或缺少 SHA 密钥。为了修复此错误，请确保所有这些条件都为真：

• 您已向 Firebase 控制台中项目的常规设置添加了一封支持电子邮件。
• 您已将发布/生产密钥库中的 SHA-1 证书指纹添加到 Firebase 控制台中的 Firebase Android 应用程序（转到项目设置，向下滚动到您的应用程序，然后选择您的 Android 应用程序）。
• 您已将SHA-1 证书指纹从 Google Play 控制台添加到 Firebase 控制台中的 Firebase Android 应用程序（转到项目设置，向下滚动到您的应用程序，然后选择您的 Android 应用程序）。