Android Firebase App Check Play Integrity校验不生效问题问询

你当前的配置存在3个显性问题，按以下步骤逐一排查即可解决，所有步骤均为线上落地验证过的操作：

一、先修正代码层面的配置错误 #

1. 对齐依赖版本：你引入的com.google.firebase:firebase-appcheck-playintegrity没有指定版本，会导致和16.0.0版本的debug依赖不兼容，直接锁死版本即可：

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

2. 修正初始化时机：不要在Activity里初始化App Check，也不要手动调用FirebaseApp.initializeApp——只要接入了google-services插件，FirebaseApp会自动初始化，手动重复调用反而会触发实例状态异常。App Check的初始化必须放在Application的onCreate最前面，在任何Firebase组件（包括Firebase Auth、Firestore等）调用之前完成，否则登录请求发出时App Check token还未生成，必然报参数缺失错误。修正后的初始化代码参考：

   class BaseApplication : Application() {
       override fun onCreate() {
           super.onCreate()
           // 初始化App Check要放在最前面
           if (BuildConfig.DEBUG) {
               Timber.plant(Timber.DebugTree())
               FirebaseAppCheck.getInstance().installAppCheckProviderFactory(
                   DebugAppCheckProviderFactory.getInstance()
               )
           } else {
               FirebaseAppCheck.getInstance().installAppCheckProviderFactory(
                   PlayIntegrityAppCheckProviderFactory.getInstance()
               )
           }
           // 之后再写其他业务初始化、Firebase相关调用逻辑
       }
   }
   

   记得在AndroidManifest.xml的application节点配置name属性指向这个自定义Application类。
3. 补全debug环境配置：使用DebugAppCheckProviderFactory时，第一次启动debug包要过滤logcat中DebugAppCheckProvider标签的日志，会打印一串本地调试密钥，把这串密钥添加到Firebase控制台App Check模块的「调试令牌」列表中，否则debug环境的请求会被直接拦截。

二、补全控制台配置遗漏 #

这部分是90%同类问题的根因：

1. 单独配置App Check的Play Integrity规则：仅在Firebase项目设置页添加SHA-1/SHA-256指纹不会自动同步到App Check配置中。你需要进入Firebase控制台的App Check模块，找到对应Android应用，手动选择Play Integrity作为校验提供商，填入对应渠道签名的SHA-256指纹保存。
2. 核对签名指纹一致性：如果应用已经上架Google Play且开启了Play应用签名功能，你本地的发布签名指纹和Google Play重签名后的指纹不一致，必须填入Google Play Console「应用完整性」页面展示的发布证书SHA-256指纹，本地签名指纹仅用于本地debug、内测渠道包校验。
3. 确认API归属项目：你在GCP启用的所有API，必须是Firebase项目绑定的那个GCP项目，不要开错到其他独立项目下。API启用后等待10-15分钟再测试，配置生效存在传播延迟。

三、校验规则与缓存排查 #

1. 临时调整校验规则验证链路：进入Firebase App Check控制台的「API」标签，找到Identity Toolkit API（对应Firebase手机号登录的后端服务），先把校验规则调整为「允许未通过验证的请求访问」，此时测试如果能正常登录，说明问题确实出在App Check token生成/传递链路，再切回强制校验模式逐一排查；如果调整规则后还是报错，说明是Firebase Auth本身的配置问题，和App Check无关。
2. 清除缓存测试：每次修改配置后，彻底卸载测试机上的应用，同时清除Google Play服务的应用缓存，旧的Firebase Installation ID、App Check token缓存会导致新配置不生效。
3. 补全混淆规则：如果是release包报错，把Firebase App Check、Play Integrity对应的官方不混淆规则加到proguard配置文件中，避免相关类被混淆导致初始化失败。
4. 确认测试环境合规：测试机必须安装正版Google Play服务，网络环境可正常访问Google服务，未root、未解锁bootloader，否则Play Integrity本身就会返回校验失败。

避坑说明 #

• 不需要反复删除重建Firebase应用，只要配置项正确即可生效，重建项目反而会导致包名、配置映射混乱。
• 不需要手动往登录请求里加App Check token参数，Firebase Auth会自动从已初始化的App Check实例中拉取token携带在请求中，手动加参反而会触发参数校验异常。
• SafetyNet已完全废弃，即使切回SafetyNet方案也无法正常通过校验，不用做无效尝试。

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