解决Play Integrity验证失败(preauth playlntegrity verification failed)的实战指南

1次阅读

共计 2450 个字符，预计需要花费 7 分钟才能阅读完成。

Play Integrity API 是 Google 提供的一种服务，用于帮助开发者验证 Android 设备的完整性。它能够检测设备是否被篡改、是否运行在模拟器上，以及设备是否符合 Google Play 服务的要求。然而，在实际开发中，我们经常会遇到 preauth playlntegrity verification failed 的错误，这可能导致应用功能受限或完全无法使用。

常见的原因包括：

设备被 Root 或安装了修改版系统
网络问题导致无法连接到 Play Integrity 服务
应用未正确配置 Play Integrity API
服务端验证令牌时出现错误

要彻底解决这个问题，我们需要一个完整的客户端和服务端验证流程：

客户端请求 nonce 并调用 Play Integrity API
Play 服务返回完整性令牌
客户端将令牌发送到服务端
服务端验证令牌的有效性和完整性
根据验证结果决定是否允许客户端继续操作

首先，在 build.gradle 中添加依赖：

dependencies {implementation 'com.google.android.play:integrity:1.0.1'}

然后实现获取完整性令牌的代码：

val integrityManager = IntegrityManagerFactory.create(applicationContext)

// 生成一个随机 nonce
val nonce = generateNonce()

val request = IntegrityTokenRequest.builder()
    .setNonce(nonce)
    .build()

integrityManager.requestIntegrityToken(request)
    .addOnSuccessListener { integrityTokenResponse ->
        val token = integrityTokenResponse.token()
        // 将 token 发送到服务端验证
        sendTokenToServer(token)
    }
    .addOnFailureListener { e ->
        // 处理失败情况
        handleIntegrityCheckFailure(e)
    }

服务端需要使用 Google 的 API 来验证令牌。以下是 Java 示例：

public boolean verifyIntegrityToken(String token, String expectedNonce) {IntegrityServiceClient integrityService = IntegrityServiceClient.create();
    VerifyIntegrityTokenRequest request = VerifyIntegrityTokenRequest.newBuilder()
        .setIntegrityToken(token)
        .build();

    try {VerifyIntegrityTokenResponse response = integrityService.verifyIntegrityToken(request);
        TokenPayloadExternal payload = response.getTokenPayloadExternal();

        // 验证 nonce 是否匹配
        if (!payload.getRequestDetails().getNonce().equals(expectedNonce)) {return false;}

        // 检查设备完整性
        return payload.getDeviceIntegrity().getDeviceRecognitionVerdictList()
            .contains(DeviceRecognitionVerdict.MEETS_DEVICE_INTEGRITY);
    } catch (Exception e) {
        // 处理验证错误
        return false;
    }
}

在客户端实现合理的错误处理和重试逻辑很重要：

private fun handleIntegrityCheckFailure(e: Exception) {when (e) {
        is ApiException -> {when (e.statusCode) {
                CommonStatusCodes.TIMEOUT -> {
                    // 网络超时，可以重试
                    retryIntegrityCheck()}
                IntegrityService.API_NOT_AVAILABLE -> {
                    // Play 服务不可用，提示用户
                    showPlayServicesError()}
                else -> {
                    // 其他错误
                    logError(e)
                }
            }
        }
        else -> {
            // 非 API 异常
            logError(e)
        }
    }
}

在实际开发中，有几个常见的陷阱需要注意：