Flutter手机号认证改用Play Integrity API后遇错误求助

1. 确认App Check与Play Integrity的绑定配置 #

• 进入Firebase控制台→项目设置→App Check→Android应用条目，确保Provider已设置为Play Integrity，且已完成应用签名证书SHA-256的验证（需和Google Play Console中应用的上传密钥、应用签名密钥完全一致）。
• 本地调试时，务必将测试设备的SHA-256添加到App Check的测试设备列表，避免触发reCAPTCHA fallback验证。

2. 修正Flutter端初始化顺序 #

• 必须在初始化Firebase Auth前启动App Check，否则认证流程无法获取有效令牌：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 优先激活Play Integrity
  await FirebaseAppCheck.instance.activate(
    androidProvider: AndroidProvider.playIntegrity,
    appleProvider: AppleProvider.appAttest,
  );
  runApp(const MyApp());
}

3. 解决reCAPTCHA fallback与sessionStorage错误 #

• 确保应用已上传至Google Play Console（至少内部测试轨道），未发布的本地包可能无法触发Play Integrity正常验证。
• 清除应用缓存和浏览器缓存，测试时使用浏览器隐私模式打开验证页面，排除存储访问异常。
• 更新设备WebView至最新版本，老旧WebView易出现sessionStorage读写问题。

4. 修复"Missing client identifier error" #

• 重新下载Firebase控制台的google-services.json文件，替换到Flutter项目android/app目录，确保文件中的client/oauth_client/client_id与控制台的OAuth 2.0客户端ID一致。
• 检查Firebase Auth的手机号认证权限，确认未设置仅允许特定客户端的限制。

5. 调试日志排查 #

• 启用App Check日志监听，定位验证失败原因：

FirebaseAppCheck.instance.onTokenRefresh.listen((token) {
  print('App Check Token: ${token.token}');
}, onError: (error) {
  print('App Check Error: $error');
});

• 在Android Studio Logcat中过滤PlayIntegrity或FirebaseAppCheck关键词，查看具体错误码（如证书不匹配、应用未发布等）。

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