集成Firebase Cloud Messaging SDK遇AUTHENTICATION_FAILED错误求助

操作流程 #

• 在Firebase控制台创建应用
• 将google-services.json下载至Unity项目的Assets文件夹
• 导入FirebaseMessaging.unitypackage
• 在Android Studio中构建应用
• 用Android Studio调试模式在MuMu模拟器运行应用

错误日志 #

I/firebase: Firebase Cloud Messaging API Initialized
I/Unity: Firebase Cloud Messaging API Initialized
E/FirebaseInstanceId: Topic sync or token retrieval failed on hard failure exceptions: AUTHENTICATION_FAILED. Won't retry the operation.
I/Unity: Firebase Messaging Initialized
I/Unity: RequestPermissionAsync completed

排查与解决步骤 #

1. 校验google-services.json有效性

   • 确认文件从对应Firebase应用的Android平台下载，而非其他平台
   • 核对文件内client[0].oauth_client.client_id与Unity项目Android Build Settings中的包名完全一致
   • 确保文件未被篡改，无格式错误或内容缺失

2. 匹配包名与签名配置

   • 打开Unity File > Build Settings > Player Settings，确认Android包名与Firebase控制台应用包名完全匹配
   • 若用调试模式运行，将调试签名的SHA-1添加至Firebase控制台项目设置的应用指纹列表
   • 确保Android Studio构建时使用的签名配置与Unity一致

3. 检查SDK版本兼容性

   • 确认FirebaseMessaging.unitypackage版本与Unity版本兼容
   • 尝试更新至最新Firebase Unity SDK，修复旧版本可能存在的认证bug

4. 排查模拟器环境

   • 确认MuMu模拟器联网正常，能访问Firebase服务
   • 切换至其他模拟器或真实设备测试，排除模拟器环境问题
   • 确保模拟器系统版本满足Firebase SDK最低要求（Android 6.0及以上）

5. 清理重建项目

   • Unity中执行Assets > Clear Cache，重新导入Firebase SDK包
   • Android Studio中执行Build > Clean Project和Build > Rebuild Project清除缓存
   • 删除Unity项目的Temp和Library文件夹，重新生成项目文件

内容的提问来源于stack exchange，提问作者user20963263