Android集成TapAndPay API时出现ClassCastException及无效参数错误

问题根源拆解 #

虽然你没有直接处理AccountInfo类，但这个ClassCastException是API内部解析PushTokenizeRequest时触发的类型转换错误，基本可以排除API内部bug，大概率是你构建请求时的参数不符合规范导致的。另外TapAndPayApiException: # eqej@a718171c是API的模糊错误码，需要结合细节排查。

核心可能原因 #

• OPC数据格式或内容错误：
  你传入的opcBytes虽然是byte[]类型，但可能不符合TapAndPay API的要求——比如TSP返回的是Base64编码的字符串，你直接把字符串转成byte[]而不是先解码；或者OPC数据本身包含无效元数据，导致API内部误将其解析为AccountInfo对象。
• UserAddress缺失必填字段：
  Google Wallet的地址校验逻辑有隐藏要求，比如部分国家/地区必须填写AdministrativeArea（州/省）字段，缺失会导致API内部解析异常，进而触发奇怪的类型转换错误。
• 依赖版本不兼容：
  项目中play-services-tapandpay的版本与设备上的Google Play Services版本不匹配，旧版本API可能存在参数处理的bug。

针对性调试建议 #

• 验证OPC数据正确性：
  • 确认TSP返回的OPC是二进制数据：如果返回的是Base64字符串，必须先用Base64.decode(opcString, Base64.DEFAULT)转成byte[]再传入，不能直接调用opcString.getBytes()。
  • 打印opcBytes的长度，对比Visa TSP文档要求的OPC长度范围，确保数据长度合规。
• 补全UserAddress的必填字段：
  添加AdministrativeArea字段（即使是可选地区，也传入空字符串或默认值），修改后的代码示例：

  UserAddress userAddress = UserAddress.newBuilder()
      .setName(name)
      .setAddress1(address)
      .setLocality(city)
      .setAdministrativeArea(province) // 新增必填字段
      .setCountryCode(countryCode)
      .setPostalCode(postalCode)
      .setPhoneNumber(phoneNumber)
      .build();
  

• 同步依赖与服务版本：
  升级项目中com.google.android.gms:play-services-tapandpay到最新稳定版，同时确保测试设备上的Google Play Services也更新到对应版本。
• 捕获详细错误码：
  在onActivityResult（或Activity Result API回调）中解析TapAndPayApiException的具体错误码，替代模糊的"Invalid argument"提示：

  @Override
  protected void onActivityResult(int requestCode, int resultCode, Intent data) {
      super.onActivityResult(requestCode, resultCode, data);
      if (requestCode == REQUEST_CODE_PUSH_TOKENIZE) {
          if (resultCode != RESULT_OK) {
              TapAndPayApiException exception = TapAndPayApiException.fromIntent(data);
              if (exception != null) {
                  Log.e("TapAndPayDebug", "错误码：" + exception.getErrorCode() + "，详情：" + exception.getMessage());
              }
          }
      }
  }
  

  常见错误码如ERROR_INVALID_PARAMETER（参数无效）、ERROR_OPC_INVALID（OPC数据无效）能直接定位问题点。

内容的提问来源于stack exchange，提问作者Vitalii Shcherbyna