Flutter中Firebase App Check发布模式失效问题及解决咨询

1. 发布模式下App Check失效的原因及解决 #

• 混淆规则缺失：启用R8混淆后，SafetyNet/Play Integrity的核心类被混淆，导致验证逻辑失效。需在android/app/proguard-rules.pro中添加以下混淆规则：

  # Firebase App Check 核心类
  -keep class com.google.firebase.appcheck.** { *; }
  # SafetyNet 相关类
  -keep class com.google.firebase.appcheck.safetynet.** { *; }
  # Play Integrity 相关类
  -keep class com.google.firebase.appcheck.playintegrity.** { *; }
  # Google Play 服务依赖类
  -keep class com.google.android.gms.common.** { *; }
  -keep class com.google.android.gms.safetynet.** { *; }
  -keep class com.google.android.gms.playintegrity.** { *; }
  

• 签名指纹配置错误：发布版App使用Google App Signing的官方签名指纹，而非本地调试指纹。需在Firebase控制台的App Check设置中，添加Google Play Console提供的发布版SHA-256指纹（路径：Google Play Console > 应用 > 发布 > 设置 > 应用签名 > 应用签名证书）。
• 令牌缓存异常：发布模式下可能存在令牌缓存失效，确保应用启动时正确调用FirebaseAppCheck.instance.activate()完成初始化。

2. Play Integrity调试模式无法工作的原因及解决 #

Play Integrity的验证依赖Google Play生态的签名与分发机制，本地调试的APK未经过Google Play官方签名，无法通过Play Integrity的完整验证流程，导致获取不到有效令牌。解决方法：

• 使用Google Play内部测试轨道：将调试版APK上传到Google Play内部测试，通过Play商店安装后调试，此时应用使用Play官方签名，Play Integrity可正常工作。
• 配置调试令牌：调用FirebaseAppCheck.instance.getToken(true)获取调试令牌，将其添加到Firebase控制台的Play Integrity提供商设置中，本地调试时可绕过完整验证流程。
• 升级Google Play服务：确保测试设备上的Google Play服务为最新版本，旧版本可能不支持Play Integrity的调试验证逻辑。

3. 是否需要添加平台级代码？ #

大部分场景下，仅通过Flutter插件firebase_app_check即可完成集成，但部分验证提供商需要额外的平台级配置（非业务代码，而是配置文件修改）：

• SafetyNet：需在android/app/src/main/AndroidManifest.xml中添加SafetyNet API密钥的meta-data：

  <meta-data
      android:name="com.google.firebase.appcheck.safetynet.api_key"
      android:value="你的SafetyNet API密钥"/>
  

• Play Integrity：无需额外编写初始化代码，但需确保Android项目依赖了Play Integrity库（插件通常会自动引入，若缺失可手动在android/app/build.gradle中添加）：

  implementation 'com.google.firebase:firebase-appcheck-playintegrity:16.0.0'
  

• 总结：无需手动编写平台级初始化代码，但必须完成对应提供商的配置文件修改和混淆规则设置。

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