支付宝沙箱H5及APP支付为何拉起生产环境并报ALIN42284

结论

ALIN42284 通常不表示订单创建失败，更常见的原因是沙箱订单被生产版支付宝处理，导致支付环境不匹配。

沙箱订单只存在于支付宝沙箱系统。生产版支付宝收到沙箱生成的 trade_no、支付链接或 orderString 后，无法在生产环境中查到对应订单，因此会提示：

抱歉，订单不存在，请检查后重试（ALIN42284）

如果代码没有改动，但 H5 和 APP 支付同时出现问题，应先检查：

• 沙箱版支付宝是否已经失效、被卸载或无法正常登录；
• 手机是否默认使用生产版支付宝打开支付链接；
• 服务端网关是否仍为 https://openapi.alipaydev.com/gateway.do；
• APP 支付 SDK 是否仍处于沙箱模式；
• 沙箱应用、密钥、账号和网关中是否混入了生产环境配置。

为什么会拉起生产版支付宝

沙箱与生产环境的数据完全隔离。即使接口名称和请求参数相同，两个环境也无法查询对方的订单。

常见的调用过程如下：

服务端在沙箱创建订单
        ↓
返回沙箱支付表单或 orderString
        ↓
客户端错误拉起生产版支付宝
        ↓
生产环境查询不到沙箱订单
        ↓
提示 ALIN42284

客户端错误拉起生产版支付宝，通常有以下几种原因。

沙箱版支付宝失效或不可用

支付宝沙箱钱包可能因版本、有效期、登录状态或安装状态变化而无法使用。即使业务代码完全没有修改，之前安装的沙箱钱包也可能已经失效。

沙箱钱包无法响应支付链接时，手机系统可能改用生产版支付宝打开。遇到这种情况，H5 和 APP 支付往往会同时受影响。

建议重新查看支付宝开放平台的沙箱页面，确认当前提供的沙箱钱包和使用说明，不要继续使用历史安装包。下载入口和支持范围可能随平台调整，应以开放平台当前页面为准。

客户端没有启用沙箱模式

APP 支付除了要求服务端调用沙箱网关，客户端支付 SDK 也要按照对应版本启用沙箱环境。

以部分 Android 支付 SDK 为例，需要在调用 payV2 前设置环境：

import com.alipay.sdk.app.EnvUtils;
import com.alipay.sdk.app.PayTask;

// 必须在发起支付前执行
EnvUtils.setEnv(EnvUtils.EnvEnum.SANDBOX);

PayTask alipay = new PayTask(activity);
Map<String, String> result = alipay.payV2(orderString, true);

EnvUtils 是否可用，以及具体应该如何设置，取决于支付宝 SDK 的版本。如果当前 SDK 没有该 API，应查阅与该版本匹配的接入文档，不能直接套用其他版本的配置。

还需要确认环境设置代码确实在支付调用之前执行，而不是放在某个实际没有运行的初始化分支中。

服务端网关被切换到了生产环境

支付宝沙箱网关通常为：

https://openapi.alipaydev.com/gateway.do

生产网关通常为：

https://openapi.alipay.com/gateway.do

Java 服务端初始化示例：

AlipayClient alipayClient = new DefaultAlipayClient(
    "https://openapi.alipaydev.com/gateway.do",
    appId,
    merchantPrivateKey,
    "json",
    "UTF-8",
    alipayPublicKey,
    "RSA2"
);

检查时应以最终运行的配置为准，不能只看代码仓库中的默认值。环境变量、配置中心、启动参数、容器配置和灰度配置都可能覆盖代码里的网关地址。

在不输出密钥的前提下，可以记录：

log.info("Alipay gateway: {}", gatewayUrl);
log.info("Alipay appId: {}", appId);

不要将私钥、支付宝公钥或完整签名内容写入日志。

沙箱与生产配置混用

一套可用的沙箱配置中，以下内容至少应属于同一个沙箱应用：

• 沙箱 app_id
• 沙箱应用私钥
• 对应的支付宝公钥或支付宝公钥证书
• 沙箱买家账号
• 沙箱卖家账号
• 沙箱网关
• 客户端沙箱环境配置

以下配置组合都可能引发异常：

沙箱 app_id + 生产密钥
生产 app_id + 沙箱网关
沙箱订单 + 生产版支付宝
生产 orderString + 沙箱钱包

如果使用证书模式，还需确认应用公钥证书、支付宝公钥证书和支付宝根证书来自同一环境，并与当前沙箱应用匹配。

建议的排查步骤

1. 确认订单是否在沙箱环境创建成功

记录支付宝接口的原始响应，重点查看：

• code
• sub_code
• sub_msg
• trade_no
• out_trade_no

客户端出现支付页面，并不等于订单已经创建成功。

如果服务端调用成功并取得沙箱订单号，之后在生产版支付宝中出现 ALIN42284，基本可以判断是钱包或客户端环境不匹配。

2. 检查实际请求网关

确认运行时请求确实发往：

openapi.alipaydev.com

如果请求发往：

openapi.alipay.com

说明请求已经进入生产环境。

应检查真实的 HTTP 请求目标或 SDK 初始化参数，不要只在代码中搜索网关字符串。

3. 重新安装并登录沙箱钱包

可以按以下顺序操作：

1. 卸载当前的沙箱版支付宝。
2. 从支付宝开放平台当前的沙箱页面重新获取安装包。
3. 使用平台提供的沙箱买家账号登录。
4. 确认沙箱钱包可以正常打开。
5. 再次测试 H5 和 APP 支付。

在部分设备上，沙箱版和生产版支付宝可能争抢同一类型的支付链接。排查时可以暂时卸载生产版支付宝，确认链接能否正确进入沙箱钱包。这个操作只用于定位问题，不是正式解决方案。

4. 清除系统默认打开方式

Android 设备可能已经把支付宝相关链接默认交给生产版支付宝。可以进入系统应用设置，清除生产版支付宝的“默认打开链接”设置，再重新测试。

不同 Android 厂商使用的菜单名称可能不同，常见位置包括：

设置 → 应用 → 支付宝 → 默认打开
设置 → 应用管理 → 支付宝 → 清除默认设置

如果清除关联后可以选择沙箱钱包，说明问题主要出在系统的链接分发环节。

5. 检查 APP 支付 SDK 的沙箱设置

确认以下条件都已满足：

• 沙箱环境设置在 payV2 或同类支付调用之前执行；
• 后续初始化代码没有将环境切回生产模式；
• 当前支付 SDK 版本支持所使用的沙箱接入方式；
• orderString 由服务端使用沙箱配置生成；
• 客户端没有替换或重新拼接 orderString。

orderString 应由服务端生成，然后原样返回客户端：

AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();

AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
model.setSubject("测试商品");
model.setOutTradeNo(outTradeNo);
model.setTotalAmount("0.01");
model.setProductCode("QUICK_MSECURITY_PAY");

request.setBizModel(model);
request.setNotifyUrl(notifyUrl);

AlipayTradeAppPayResponse response =
    alipayClient.sdkExecute(request);

String orderString = response.getBody();

客户端不应解析并重新排列其中的参数，否则可能破坏签名。

6. 检查 H5 支付返回内容

H5 支付通常由服务端调用接口并返回支付表单：

AlipayTradeWapPayRequest request = new AlipayTradeWapPayRequest();

AlipayTradeWapPayModel model = new AlipayTradeWapPayModel();
model.setSubject("测试商品");
model.setOutTradeNo(outTradeNo);
model.setTotalAmount("0.01");
model.setProductCode("QUICK_WAP_WAY");
model.setQuitUrl(quitUrl);

request.setBizModel(model);
request.setReturnUrl(returnUrl);
request.setNotifyUrl(notifyUrl);

AlipayTradeWapPayResponse response =
    alipayClient.pageExecute(request);

String paymentForm = response.getBody();

检查返回表单中的提交地址是否指向沙箱域名。不要在前端把沙箱域名替换成生产域名，也不要自行修改支付宝返回的跳转参数。

如果浏览器先进入沙箱地址，随后却唤起生产版支付宝，应重点检查沙箱钱包的安装状态、系统默认链接关联和客户端环境设置。

如何快速判断问题发生在哪一层

可以根据以下现象缩小排查范围：

注意事项

• ALIN42284 表示当前被拉起的环境找不到对应订单，但不能只凭这个错误码断定订单已经创建成功，仍需核对服务端响应。
• 修改订单号、重复提交或更换 out_trade_no 无法解决环境错配，不要用这些方式规避错误。
• 沙箱与生产配置应彻底隔离，建议使用独立的配置文件或配置项，不要只靠代码注释切换环境。
• 不要把私钥、完整签名串或沙箱账号密码写入日志。
• 沙箱钱包的安装方式、支持平台和 SDK 配置可能调整，应以支付宝开放平台当前的沙箱文档及所用 SDK 版本说明为准。
• 如果重新安装沙箱钱包、清除默认关联并核对网关后仍能复现，应整理请求时间、app_id、接口名称、out_trade_no、支付宝返回的 trade_no 和完整错误响应，再提交给支付宝技术支持。不要随工单上传敏感密钥。

备注：内容仅供参考。