问题排查

沙盒正常运行时间

沙盒环境不像我们的生产环境那样有正常运行时间服务等级协议 (SLA)。 如果您遇到疑似与沙盒服务中断相关的错误，请等待一个美国工作日，然后再与我们联系。服务中断通常会在该时间段内自行解决。由于可能会出现停机，因此请勿将任何关键发布流程设计为依赖于沙盒环境。

在 Android 设备上启用和停用沙盒模式

您可以使用 TapAndPay 环境设置启用沙盒模式。如需返回生产模式，请按照上述相同步骤操作，但选择生产模式，而不是沙盒模式。

使用 TapAndPay 环境设置

执行以下步骤以启用沙盒模式：

  1. 打开设置应用。
  2. 点按屏幕最顶部的 Google 账号 / 个人资料照片（其中会显示您的姓名和“Google 服务和偏好设置”）。
  3. 如果系统提示，请选择您的个人资料，然后点按所有服务。
  4. 滚动到其他类别，然后点按触碰付款环境。如果您没有看到 TapAndPay Environment，请重启设备，然后从第 1 步开始重新操作。
  5. 点按下拉菜单，然后选择SANDBOX。
    6. 环境更改确认屏幕截图
  6. 您应该会看到以下对话框，通知您环境已发生变化。点按确定，然后重启设备。
    7. 环境更改确认屏幕截图

同步 Google 钱包环境

在重启后打开 Google 钱包时，您可能会看到以下对话框，该对话框会要求您强行停止并重新打开 Google 钱包：

环境更改确认屏幕截图

在 Wear OS 设备上启用和停用沙盒模式

如需在已连接的 Wear OS 设备上启用沙盒模式，请添加一个空文件并重新启动，如以下示例所示：

adb shell touch /sdcard/Download/android_pay_env_override_sandbox
adb reboot

如需在已连接的 Wear OS 设备上切换回生产模式，请删除该文件并重启设备，如以下示例所示：

adb shell rm /sdcard/Download/android_pay_env_override_sandbox
adb reboot

检查您的 Android 设备是处于沙盒模式还是生产模式

如需查看您的 Android 设备是处于沙盒模式还是生产模式，请执行以下步骤

  1. 打开 Google 钱包应用 。
  2. 在右上角，依次点按您的个人资料照片或账号 > 钱包设置。
  3. 转到页面末尾。如果您看到一条显示“SANDBOX”的确认消息，则表示您已配置为进行沙盒调用。如果您没有看到消息，则表示您已配置为进行生产调用。
生产模式下的钱包设置
图 1：生产模式
沙盒模式下的钱包设置
图 2：沙盒模式

部分设备的 Google 设置中没有 Google 钱包。如需访问 Google 钱包设置，您需要将 adb 与以下命令搭配使用：

adb shell am start -a com.google.android.gms.tapandpay.settings.VIEW_HOME -n com.google.android.gms/com.google.android.gms.tapandpay.settings.TapAndPaySettingsActivity

Google 托管的端点

通知端点返回 HTTP 404

首先，验证您是否调用了正确的端点。如果您仍然看到 404 错误，则可能是 mTLS 证书配置不正确。请联系您的 Google 代表，并提供相关证书。

发卡机构托管的端点

写入服务器失败 / I/O 错误 / HTTP 413

发卡机构应确保将请求的内容长度上限设置为至少 20 MB。