阿里云验证码2.0这个排查方式是什么呢？

问题分析

阿里云验证码2.0支持多种验证形态，包括滑块验证、拼图验证、空间推理、图像复原和无痕验证等。在滑块验证和图形验证中，captchaVerifyCallback 和 onBizResultCallback 回调函数会返回参数，用于处理业务逻辑。然而，在切换到无痕验证时，由于无痕验证的特性（无需用户交互即可完成验证），这些回调函数可能不会返回参数。

以下是针对该问题的排查方式和解决方案：

排查方式与解决方案

1. 确认无痕验证的特性

无痕验证是一种基于用户行为和设备数据的自动化验证方式，通常不需要用户进行显式的交互操作（如滑动滑块或完成拼图）。因此，无痕验证的流程设计中，captchaVerifyCallback 和 onBizResultCallback 的参数返回机制可能会有所不同。

• 无痕验证的核心逻辑：
  • 如果用户被判定为低风险，则直接通过验证，不触发回调函数。
  • 如果用户被判定为高风险，则触发二次验证（如滑块验证或拼图验证），此时才会调用 captchaVerifyCallback 和 onBizResultCallback。

2. 检查客户端代码逻辑

确保客户端代码能够正确处理无痕验证的场景。以下是一些关键点：

• 调整 captchaVerifyCallback 的实现： 在无痕验证中，如果用户被判定为低风险，captchaVerifyCallback 可能不会被调用。因此，需要在代码中添加对无痕验证结果的判断逻辑。例如：

  async function captchaVerifyCallback(captchaVerifyParam) {
    if (!captchaVerifyParam) {
        console.log("无痕验证通过，无需额外参数");
        return { captchaResult: true, bizResult: true };
    }
    // 处理其他验证形态的逻辑
    const result = await fetch('http://您的业务请求地址', {
        method: 'POST',
        body: JSON.stringify({ captchaVerifyParam }),
    });
    return { captchaResult: result.captchaVerifyResult, bizResult: result.bizResult };
  }
  

• 调整 onBizResultCallback 的实现： 如果无痕验证通过，onBizResultCallback 可能不会被触发。因此，建议将业务逻辑从 onBizResultCallback 中解耦，改为在 captchaVerifyCallback 中统一处理。

3. 服务端接口调用检查

无痕验证的结果由服务端通过调用 VerifyIntelligentCaptcha 接口返回。需要确保服务端能够正确解析无痕验证的结果，并根据返回值处理业务逻辑。

• 服务端返回值说明：

  • 如果返回值为 T001，表示验证通过。
  • 如果返回值为 F001，表示疑似攻击请求，需触发二次验证。
  • 如果返回值为 F004，表示控制台配置了测试模式且验证未通过。

• 服务端代码示例：

  const verifyResult = await VerifyIntelligentCaptcha({
    CaptchaVerifyParam: captchaVerifyParam,
  });
  if (verifyResult.VerifyCode === 'T001') {
    console.log("无痕验证通过");
    // 执行业务逻辑
  } else if (verifyResult.VerifyCode === 'F001' || verifyResult.VerifyCode === 'F004') {
    console.log("触发二次验证");
    // 调用滑块验证或其他验证形态
  }
  

4. 控制台配置检查

无痕验证的行为受控制台策略配置的影响。请登录验证码2.0控制台，检查以下配置项：

• 验证场景策略： 确保当前验证场景已启用无痕验证，并正确配置了风险策略。
• 测试模式： 如果启用了测试模式，请确认是否配置了验证通过或验证不通过的模拟结果。

5. 日志排查

如果上述步骤仍无法解决问题，可以通过日志排查具体原因：

• 客户端日志： 检查 captchaVerifyCallback 和 onBizResultCallback 是否被调用，以及调用时的参数内容。
• 服务端日志： 检查 VerifyIntelligentCaptcha 接口的返回值，确认验证结果是否符合预期。

总结

无痕验证的特性决定了其在低风险场景下不会触发显式的回调函数。为了适配无痕验证，需要调整客户端和服务端的代码逻辑，确保能够正确处理无参数返回的情况。同时，建议检查控制台配置和日志信息，以进一步排查潜在问题。