迁移至Google Play Integrity API遇两类错误求原因解析

错误(-8)：请求过于频繁被限流（调用setCloudProjectNumber时触发） #

可能原因 #

• 短时间内发起过多请求，触发Integrity API的默认频率配额限制
• 配置的Cloud项目编号无效，导致每次请求失败后重复重试，加剧限流
• 未实现规范的指数退避重试逻辑，短时间内重复请求

解决步骤 #

• 验证Cloud项目编号正确性：确保使用的是Google Play Console中与当前应用关联的Cloud项目编号，路径：Play Console > 设置 > API服务 > 关联的Google Cloud项目，不要使用未关联的项目ID
• 检查并调整API配额：登录Google Cloud Console，找到对应项目的「Google Play Integrity API」页面，查看当前配额使用情况，若配额不足可提交配额提升申请
• 严格实现指数退避：重试逻辑需遵循指数间隔（如1s→2s→4s→8s），最多重试3-5次，避免短时间内大量重复请求
• 测试阶段控制请求频率：调试时避免循环调用接口，减少不必要的请求

错误(-12)：未知内部服务器错误（移除setCloudProjectNumber时触发） #

可能原因 #

• 应用与Cloud项目的关联关系未同步完成，导致API无法自动匹配正确项目
• 关联的Cloud项目未启用Google Play Integrity API
• 使用了非Google Play签名的应用包（如本地调试签名）发起请求
• Google服务器临时同步延迟

解决步骤 #

• 确认项目关联与API启用状态：
  1. 在Play Console中确认应用已绑定正确的Cloud项目
  2. 登录对应Cloud项目，搜索「Google Play Integrity API」并确认服务已启用
• 使用Play签名的应用包测试：必须使用从Google Play Store获取的应用（或Play Console内部测试/封闭测试包），本地调试签名的包无法通过Integrity API验证
• 等待服务器同步：若刚完成项目关联或API启用，需等待1-2小时让Google服务器完成同步后重试
• 清除应用缓存并重启：清除应用缓存后重新发起请求，避免本地缓存的无效配置影响

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