Android端启用Firebase App Check后Firestore查询全部被拒绝的排查求助

首先，针对你遇到的PERMISSION_DENIED错误，我们可以从几个方向排查并获取更详细的错误信息：

一、查看App Check/Play Integrity的错误详情 #

1. Firebase控制台App Check日志
   登录Firebase控制台，进入项目的「App Check」页面，切换到「事件」标签页。这里会记录所有App Check验证的结果，包括失败的具体原因——比如Token无效、应用包名不匹配、设备未通过Play Integrity验证等，这些信息能直接帮你定位核心问题。

2. 启用Firebase调试日志
   在你的appCheck()方法前添加日志启用代码，这样能获取更完整的App Check与Firestore交互日志：

   FirebaseApp.setLoggingEnabled(true)
   FirebaseApp.initializeApp(this)
   // 后续的App Check初始化代码
   

   运行应用后查看Logcat，你会看到App Check请求Token、验证Token的全流程细节，包括任何失败的具体触发原因。

3. 手动验证Play Integrity Token
   你可以单独调用Play Integrity的API获取Token，再通过Firebase的App Check验证端点手动验证Token有效性。这能帮你区分是Play Integrity本身返回了无效Token，还是App Check的验证环节出了问题。

二、是否必须上传Play商店版本才能通过验证？ #

是的，Play Integrity App Check Provider要求应用必须通过Google Play签名机制签名——这意味着你需要将应用上传到Play商店的测试渠道（内部测试、封闭测试均可）或正式发布渠道。本地调试时使用自签名APK的话，Play Integrity无法完成完整的设备与应用完整性验证，会导致App Check Token无效，进而触发Firestore的权限拒绝。

如果想在本地调试时绕过这个限制，可以使用App Check Debug Provider：

1. 在Firebase控制台的App Check页面，为你的应用启用Debug Provider。
2. 在本地代码中切换到Debug Provider初始化：

   firebaseAppCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance()
   )
   

3. 运行应用后，Logcat会输出一个调试Token，将这个Token添加到Firebase控制台的Debug设备列表中，即可让本地调试正常通过App Check验证。

三、IAM角色与Firestore规则排查 #

1. 检查Firestore规则
   启用App Check后，你的Firestore规则需要允许经过App Check验证的请求。之前未启用App Check时规则正常，可能是因为规则仅允许认证用户访问，现在需要添加App Check的验证条件。比如修改规则为：

   rules_version = '2';
   service cloud.firestore {
     match /databases/{database}/documents {
       match /{document=**} {
         allow read, write: if request.app != null; // 允许通过App Check验证的请求
         // 也可结合用户认证：allow read, write: if request.auth != null || request.app != null;
       }
     }
   }
   

   注意：请根据实际业务需求调整规则，避免过度开放权限。

2. IAM角色配置检查
   确认Firebase App Check的服务账号拥有正确权限：

   • 登录Google Cloud控制台，进入项目的「IAM」页面。
   • 找到名为firebaseappcheck.googleapis.com的服务账号，确保它拥有「Firebase App Check Token Verifier」角色，或包含firebaseappcheck.token.verify权限的自定义角色。

按照以上步骤排查，应该能快速定位并解决问题。

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