Flutter应用上架Google Play后Google Sign-In功能失效求助

针对同包名旧项目更新后，Google Sign-In本地正常但上架后失效的问题，以下是针对性的排查和解决步骤：

1. 强制更新Firebase配置文件 #

添加新的SHA密钥到Firebase后台后，必须下载最新的google-services.json替换项目中的对应文件，然后执行以下操作重新打包：

flutter clean
flutter build appbundle --release

很多开发者会忽略这一步，只在Firebase后台添加密钥但不更新本地配置，导致签名验证不匹配。

2. 确认Google Play应用签名密钥已完全配置 #

如果你的应用在Google Play启用了应用签名（默认开启），需要将Play控制台「应用签名」页面下的SHA-1和SHA-256密钥全部添加到Firebase项目设置的「应用签名」区域，不能只添加上传密钥。

3. 同步Google Cloud Console的OAuth客户端ID #

同包名的旧项目可能已在Google Cloud生成过OAuth客户端ID，需确认：

• 登录Google Cloud Console → 进入对应项目 → 「API和服务」→「凭据」
• 找到对应包名的OAuth 2.0客户端ID，检查其SHA指纹是否包含Google Play应用签名的密钥
• 如果存在多个客户端ID，确保Firebase认证设置中已包含所有相关的客户端ID信息

4. 增强错误日志捕获 #

当前的错误捕获可能无法覆盖所有静默失败场景，建议在登录流程中添加详细日志，定位失败节点：

try {
  FirebaseCrashlytics.instance.log("Google Sign In: 开始执行登录流程");
  final GoogleSignInAccount? googleSignInAccount = await _googleSignIn.signIn();
  FirebaseCrashlytics.instance.log("Google Sign In: 获取账号信息完成，账号名: ${googleSignInAccount?.displayName}");
  
  if (googleSignInAccount != null) {
    FirebaseCrashlytics.instance.log("Google Sign In: 开始获取认证信息");
    final GoogleSignInAuthentication googleSignInAuthentication = await googleSignInAccount.authentication;
    FirebaseCrashlytics.instance.log("Google Sign In: 获取认证信息完成");
    
    final AuthCredential credential = GoogleAuthProvider.credential(
      accessToken: googleSignInAuthentication.accessToken,
      idToken: googleSignInAuthentication.idToken,
    );
    
    FirebaseCrashlytics.instance.log("Google Sign In: 开始通过凭证登录");
    return await _auth.signInWithCredential(credential);
  } else {
    FirebaseCrashlytics.instance.log("Google Sign In: 用户取消登录或账号为空");
  }
} catch (error, stackTrace) {
  FirebaseCrashlytics.instance.log("Google Sign In 错误详情: $error");
  FirebaseCrashlytics.instance.recordError(error, stackTrace);
  rethrow;
}

通过Crashlytics的日志可以明确是登录流程的哪一步出现问题，是signIn()阶段静默失败，还是后续认证步骤出错。

5. 检查打包签名配置 #

如果使用App Bundle上传，确认android/app/build.gradle中的签名配置是否指向上传密钥，而非本地release密钥。示例配置：

signingConfigs {
   release {
       keyAlias 'upload'
       keyPassword 'your_password'
       storeFile file('upload-keystore.jks')
       storePassword 'your_password'
   }
}
buildTypes {
   release {
       signingConfig signingConfigs.release
   }
}

6. 清除设备缓存并重置测试环境 #

测试上架后的应用时，执行以下操作：

• 清除Google Play应用缓存和数据
• 退出设备上的Google账号，重新登录后再测试Google Sign-In功能
• 避免使用模拟器，优先用真实设备测试

内容的提问来源于stack exchange，提问作者Eren Malkoç