如果您的应用发出 Play Integrity API 请求，但调用失败，您的应用会收到错误代码。这些错误可能由多种原因造成，例如环境问题（例如网络连接不佳）、API 集成问题，或恶意活动和主动攻击。所返回错误代码的类型取决于请求的类型：
- 标准请求：API 会返回 StandardIntegrityErrorCode。
- 传统请求：API 会返回 IntegrityErrorCode。
重试策略
对在后台发生的 Play Integrity 操作使用指数退避算法，该算法在用户进行会话时不影响用户体验。
例如，在确认新购买交易时可以实现此算法，因为此操作可以在后台进行，如果出现错误，则不需要实时进行确认。
第一次失败后，先延迟 5 秒钟，然后再重试。
实现重试策略，将尝试次数上限作为退出条件，每次都会以指数方式增加延迟时间（10 秒、20 秒）。
执行这些重试操作时，请检查网络连接，并避免设备过载。
如果您在尝试 3 次后仍然看到错误，请将结果视为客户端未通过所有完整性检查。该错误可能由多种原因导致，包括（但不限于）：设备过载、网络连接问题或攻击者的恶意尝试。
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）
客户端设备上出现暂时性错误。
对于标准 API 请求，此错误代码从 适用于 Kotlin 和 Java 的 Play Integrity API 库 1.3.0 版、Google Play Integrity Plugin for Unity 1.3.0 或更高版本以及 Play Core 原生 SDK 1.13.0 或更高版本开始受支持。
可能的解决方案
使用指数退避算法重试。
另请参阅
对于传统请求，返回 CLIENT_TRANSIENT_ERROR。
注意：使用传统 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）与软件包管理器中的 UID 不符。
可能的解决方案
不可操作。请将结果视为客户端未通过所有完整性检查。
另请参阅
如需了解传统请求，请参阅 APP_UID_MISMATCH。
CANNOT_BIND_TO_SERVICE（错误代码 -9）
绑定到 Play 商店中的服务时失败。这可能是因为设备上安装的 Play 商店版本太低。
可能的解决方案
让用户更新 Google Play 商店。
另请参阅
如需了解传统请求，请参阅 CANNOT_BIND_TO_SERVICE。
NONCE_TOO_SHORT（错误代码 -10）
注意：只有通过 IntegrityErrorCode 发出的传统请求才会报告此值。
Nonce 长度过短。 Nonce 的长度必须至少为 16 字节（在 base64 编码之前）。
可能的解决方案
使用更长的 Nonce 重试。
NONCE_TOO_LONG（错误代码 -11）
注意：系统仅针对通过 IntegrityErrorCode 发出的传统请求报告此值。
Nonce 长度过长。 Nonce 的长度必须小于 500 字节（在 base64 编码之前）。
可能的解决方案
使用更短的 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 项目的编号。
另请参阅
如需了解传统请求，请参阅 CLOUD_PROJECT_NUMBER_IS_INVALID。
REQUEST_HASH_TOO_LONG（错误代码 -17）
注意：只有在通过 StandardIntegrityErrorCode 使用标准请求时，才会报告此错误。
提供的 requestHash 过长。requestHash 的长度必须不超过 500 个字符。
可能的解决方案
请使用更短的 requestHash 重试。
INTEGRITY_TOKEN_PROVIDER_INVALID（错误代码 -19）
注意：只有通过 StandardIntegrityErrorCode 发出的标准请求才会报告此值。
StandardIntegrityTokenProvider 无效。此错误代码仅适用于标准 API 请求，从 Kotlin 和 Java 编程语言的库版本 1.3.0、Google Play Integrity Plugin for Unity 1.3.0 或更高版本以及 Play Core 原生 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。