发布模式下Flutter Google Signin失效,抛出PlatformException
Flutter发布模式Google登录PlatformException错误(错误码10)解决方案
针对你遇到的PlatformException(sign_in_failed, com.google.android.gms.common.api.b: 10:)错误,以下是排查和解决步骤:
1. 补充添加发布版SHA-256指纹到Firebase
发布模式下仅配置SHA-1是不够的,需同时添加SHA-256指纹:
- 打开终端,执行命令生成发布密钥库的SHA指纹:
keytool -list -v -keystore /path/to/your/release-keystore.jks -alias your-key-alias - 复制输出中的SHA-256值,到Firebase控制台→项目设置→应用→添加指纹,将SHA-256粘贴进去。
2. 更新google-services.json文件
完成指纹添加后,重新下载Firebase的google-services.json文件,替换到Flutter项目的android/app目录下,确保发布版使用最新配置。
3. 检查Google Cloud Console的OAuth客户端配置
- 打开Google Cloud Console,找到你的项目,进入API和服务→凭据页面。
- 确认存在对应Android应用的OAuth 2.0客户端ID,且其配置的SHA-1、SHA-256指纹与你添加的一致。
- 若客户端ID缺失或配置错误,可手动重新创建,确保包名和指纹完全匹配。
4. 修复代码中的潜在问题
你的代码存在几个可能触发异常的点:
- 重复初始化Firebase:
await Firebase.initializeApp()应在App启动时(如main函数中)仅执行一次,而非每次登录时调用,避免初始化冲突。 - 空指针风险:当
googleSignInAccount为null时,后续代码仍会执行导致空指针,需提前终止流程:final GoogleSignInAccount? googleSignInAccount = await googleSignIn.signIn(); if (googleSignInAccount == null) { setState(() { isLoadingGoogleLogin = false; vnForPreventClickWhenLoading.value = false; }); return null; // 此处必须返回,终止后续代码执行 } - 冗余的signOut调用:
googleSignIn.signOut()在登录前调用并非必要,若用户未登录会无意义执行,可考虑移除或调整逻辑。
5. 配置ProGuard规则(若启用)
如果发布版启用了ProGuard混淆,需添加Google登录相关规则避免核心代码被混淆:
在android/app/proguard-rules.pro文件中添加:
-keep class com.google.android.gms.auth.api.signin.** { *; } -keep class com.google.firebase.auth.** { *; }
6. 确认发布密钥库匹配
确保打包发布APK/App Bundle时使用的密钥库,与生成SHA指纹时使用的是同一个,很多时候因误用debug密钥库的指纹导致验证失败。
内容的提问来源于stack exchange,提问作者conduct exam
相关产品推荐
相关产品推荐

