如果应用使用 Play Integrity API 发出请求，但调用失败，系统会返回错误代码。返回的错误代码类型取决于请求类型。
- 标准请求：API 返回 StandardIntegrityErrorCode。
- 经典请求：API 返回 IntegrityErrorCode。
重试策略
对于在后台发生且在用户会话期间不影响用户体验的 Play Integrity 操作，请使用指数退避。
例如，在确认新购买时，适合实施此策略，因为此操作可以在后台进行，并且如果发生错误，确认无需实时进行。
首次失败后，在重试前先等待 5 秒钟。
实施重试策略，将最大尝试次数作为退出条件，并每次以指数方式增加延迟（10 秒、20 秒）。
执行这些重试尝试时，检查网络连接，不要使设备过载。
如果在三次重试尝试后仍然出现错误，请将结果视为客户端未能通过所有完整性检查。错误可能有多种原因，包括（但不限于）：设备过载、网络连接问题或攻击者尝试。
Java 库的错误代码值
原生库的其他错误代码值
可重试的错误代码
这些错误有时是由于暂时性情况引起的，因此您应该重试调用。
NETWORK_ERROR（错误代码 -3）
此错误表示设备与 Play 系统之间的网络连接存在问题。
可能的解决方案
要恢复，请让用户检查网络连接，并根据触发错误的操作使用简单的重试或指数退避。
另请参阅
针对经典请求的 NETWORK_ERROR。
TOO_MANY_REQUESTS（错误代码 -8）
调用应用对 API 发送了太多请求，已被限制。
可能的解决方案
- 请求提高每日最大请求次数
- 使用指数退避进行重试。
另请参阅
针对经典请求的 TOO_MANY_REQUESTS。
GOOGLE_SERVER_UNAVAILABLE（错误代码 -12）
未知内部 Google 服务器错误。
可能的解决方案
使用指数退避进行重试。如果持续失败，请考虑提交 bug。
另请参阅
针对经典请求的 GOOGLE_SERVER_UNAVAILABLE。
CLIENT_TRANSIENT_ERROR（错误代码 -18）
客户端设备上发生了暂时性错误。
对于 Standard API 请求，此错误自以下版本开始支持：Kotlin 和 Java 的 Play Integrity API 库版本 1.3.0；适用于 Unity 的 Google Play Integrity 插件版本 1.3.0 或更高版本；以及 Play Core 原生 SDK 版本 1.13.0 或更高版本。
可能的解决方案
使用指数退避进行重试。
另请参阅
针对经典请求的 CLIENT_TRANSIENT_ERROR。
注意：使用 Classic API 请求时报告此错误，返回的值为 -17。
INTERNAL_ERROR（错误代码 -100）
未知内部错误。
可能的解决方案
使用指数退避进行重试。如果持续失败，请考虑提交 bug。
另请参阅
针对经典请求的 INTERNAL_ERROR。
STANDARD_INTEGRITY_INTERNAL_ERROR（错误代码 -100）
未知内部错误。
可能的解决方案
使用指数退避进行重试。如果持续失败，请考虑提交 bug。
另请参阅
请参阅针对经典请求的 INTEGRITY_INTERNAL_ERROR。
STANDARD_INTEGRITY_INITIALIZATION_FAILED（错误代码 -102）
初始化 Standard Integrity API 时出错。
可能的解决方案
使用指数退避进行重试。如果持续失败，请考虑提交 bug。
另请参阅
请参阅针对经典请求的 INTEGRITY_INITIALIZATION_FAILED。
不可重试的错误代码
在此类情况下，自动重试不太可能有帮助。但是，如果用户解决了导致问题的情况，手动重试可能会有帮助。例如，如果用户将 Play 商店版本更新到支持的版本，则手动重试初始操作可能奏效。
API_NOT_AVAILABLE（错误代码 -1）
设备上安装的 Play 商店版本可能太旧，且 Integrity API 不可用。另一种可能性是未在 Google Play 管理中心启用 Integrity API。
可能的解决方案
- 确保已在 Google Play 管理中心启用 Integrity API。
- 请用户更新 Play 商店。
另请参阅
请参阅针对经典请求的 API_NOT_AVAILABLE。
PLAY_STORE_NOT_FOUND（错误代码 -2）
设备上未找到官方 Play 商店应用。
可能的解决方案
请用户安装或启用 Google Play 商店。
另请参阅
请参阅针对经典请求的 PLAY_STORE_NOT_FOUND。
PLAY_STORE_ACCOUNT_NOT_FOUND（错误代码 -4）
注意：此错误仅通过 IntegrityErrorCode 针对经典请求报告。
设备上未找到 Play 商店账号。请注意，Play Integrity API 现在支持未经验证的请求。此错误代码仅用于缺少支持的旧版 Play 商店。
可能的解决方案
请用户更新并登录 Google Play 商店。
APP_NOT_INSTALLED（错误代码 -5）
调用应用未安装。可能存在问题（可能是攻击）。
可能的解决方案
不可操作。将结果视为客户端未能通过所有完整性检查。
另请参阅
请参阅针对经典请求的 APP_NOT_INSTALLED。
PLAY_SERVICES_NOT_FOUND（错误代码 -6）
Play 服务不可用或需要更新。
可能的解决方案
请用户安装、更新或启用 Play 服务。
另请参阅
请参阅针对经典请求的 APP_NOT_INSTALLED。
APP_UID_MISMATCH（错误代码 -7）
调用应用的 UID（用户 ID）与软件包管理器中的不匹配。
可能的解决方案
不可操作。将结果视为客户端未能通过所有完整性检查。
另请参阅
请参阅针对经典请求的 APP_UID_MISMATCH。
CANNOT_BIND_TO_SERVICE（错误代码 -9）
绑定到 Play 商店中的服务失败。可能是因为设备上安装的 Play 商店版本太旧。
可能的解决方案
请用户更新 Google Play 商店。
另请参阅
请参阅针对经典请求的 CANNOT_BIND_TO_SERVICE。
NONCE_TOO_SHORT（错误代码 -10）
注意：此错误仅通过 IntegrityErrorCode 针对经典请求报告。
Nonce 长度太短。base64 编码前，nonce 必须至少有 16 字节。
可能的解决方案
使用更长的 nonce 重试。
NONCE_TOO_LONG（错误代码 -11）
注意：此错误仅通过 IntegrityErrorCode 针对经典请求报告。
Nonce 长度太长。base64 编码前，nonce 必须小于 500 字节。
可能的解决方案
使用更短的 nonce 重试。
NONCE_IS_NOT_BASE64（错误代码 -13）
注意：此错误仅通过 IntegrityErrorCode 针对经典请求报告。
Nonce 未编码为 base64 网络安全无换行字符串。
可能的解决方案
使用正确格式的 nonce 重试。
PLAY_STORE_VERSION_OUTDATED（错误代码 -14）
Google Play 商店应用需要更新。
可能的解决方案
请用户更新 Google Play 商店。
另请参阅
请参阅针对经典请求的 PLAY_STORE_VERSION_OUTDATED。
PLAY_SERVICES_VERSION_OUTDATED（错误代码 -15）
Google Play 服务需要更新。
可能的解决方案
请用户更新 Google Play 服务。
另请参阅
请参阅针对经典请求的 PLAY_SERVICES_VERSION_OUTDATED。
CLOUD_PROJECT_NUMBER_IS_INVALID（错误代码 -16）
提供的云项目编号无效。
可能的解决方案
请使用您已启用 Play Integrity API 的云项目的云项目编号。
另请参阅
请参阅针对经典请求的 CLOUD_PROJECT_NUMBER_IS_INVALID。
REQUEST_HASH_TOO_LONG（错误代码 -17）
注意：此错误仅通过 StandardIntegrityErrorCode 使用标准请求时报告。
提供的 requestHash 太长。requestHash 长度必须小于 500 个字符。
可能的解决方案
使用更短的 requestHash 重试。
INTEGRITY_TOKEN_PROVIDER_INVALID（错误代码 -19）
注意：此错误仅通过 StandardIntegrityErrorCode 针对标准请求报告。
StandardIntegrityTokenProvider 无效。此错误代码仅适用于 Standard API 请求，从 Kotlin 和 Java 编程语言的库版本 1.3.0、适用于 Unity 的 Google Play Integrity 插件 1.3.0 或更高版本以及 Play Core Native SDK 1.13.0 或更高版本开始支持。
可能的解决方案
请求新的完整性令牌提供程序。
STANDARD_INTEGRITY_INITIALIZATION_NEEDED（错误代码 -101）
StandardIntegrityManager 未初始化。
可能的解决方案
请先调用 StandardIntegrityManager_init()。
另请参阅
请参阅针对经典请求的 INTEGRITY_INITIALIZATION_NEEDED。
STANDARD_INTEGRITY_INVALID_ARGUMENT（错误代码 -103）
传递给 Standard Integrity API 的参数无效。
可能的解决方案
使用正确的参数重试。
另请参阅
请参阅针对经典请求的 INTEGRITY_INVALID_ARGUMENT。