沙箱环境H5支付报错“订单不存在”如何解决？

2026-10-24支付小周

结论

返回 H5 页面只能说明商户端生成了支付请求，不能证明支付宝已经创建了可支付订单。

拉起沙箱支付宝后提示“订单不存在”，通常是支付环境或账号不一致。例如，下单请求发到了沙箱，客户端却按正式环境处理；或者 app_id、密钥、买家账号、支付链接使用错误。支付表单参数或签名有误时，支付宝也可能没有真正受理这笔订单。

常见原因

1. 沙箱与正式环境混用

沙箱请求必须发送到沙箱网关：

https://openapi-sandbox.dl.alipaydev.com/gateway.do

如果下单使用沙箱网关，后续却交给正式版支付宝处理，由于两个环境的数据不互通，客户端会查询不到订单。

正式环境生成的订单同样不能在沙箱支付宝中支付。

2. `app_id`、密钥或支付宝公钥不属于同一个沙箱应用

以下配置必须来自同一个沙箱应用：

app_id
应用私钥
支付宝公钥
签名方式，例如 RSA2
沙箱网关地址

常见的配置错误有：

使用沙箱 app_id，却配置了正式应用私钥；
把应用公钥误填到“支付宝公钥”位置；
修改密钥后，服务端仍在加载旧配置；
多套配置同时存在，程序运行时实际读取了正式环境配置。

3. 使用了不匹配的买家账号

沙箱支付应使用沙箱后台提供的买家账号。正式支付宝账号与沙箱买家账号属于不同的账户体系。

需要逐项确认：

沙箱支付宝登录的是当前沙箱应用对应的测试买家；
系统没有切换到正式版支付宝；
测试账号状态正常；
账号和支付密码来自当前沙箱环境，而非历史项目配置。

4. H5 页面已经生成，但支付请求并未真正受理

服务端调用 alipay.trade.wap.pay 后，通常会返回一段 HTML 表单。收到这段 HTML，只能证明商户系统完成了参数组装和签名，无法单独证明支付宝侧已经存在有效交易。

表单没有自动提交、参数被前端改写、跳转链接被截断或签名验证失败，都可能导致最终找不到订单。

5. `out_trade_no` 使用不当

需要检查：

out_trade_no 是否为空；
是否包含异常空格或不可见字符；
是否被重复使用；
前后端传递时是否被截断或发生编码变化；
查询订单使用的单号是否与下单时完全一致。

同一商户应用下，商户应保证 out_trade_no 唯一。调试时不要反复使用旧单号，建议每次测试都生成新的单号。

排查步骤

第一步：确认实际请求地址

不要只看配置文件，还要记录程序运行时最终使用的网关地址。沙箱环境应为：

https://openapi-sandbox.dl.alipaydev.com/gateway.do

同时检查返回页面中表单的 action，确认它仍指向沙箱域名，没有被代理、前端代码或网关配置替换。

第二步：核对运行时支付参数

重点记录以下字段，但不要把密钥写入日志：

method=alipay.trade.wap.pay
app_id=沙箱应用APPID
sign_type=RSA2
product_code=QUICK_WAP_WAY
out_trade_no=本次唯一商户订单号
total_amount=合法金额

还要确认字符集与签名配置一致，通常使用：

charset=UTF-8
sign_type=RSA2

第三步：使用查询接口验证订单

使用同一套沙箱配置调用 alipay.trade.query，查询本次下单所用的 out_trade_no。

如果查询接口也返回交易不存在，问题出在订单创建或表单提交阶段。此时应重点检查：

H5 表单是否真正提交；
网关地址是否正确；
签名是否通过；
app_id 与密钥是否匹配；
biz_content 是否完整。

如果查询接口能够找到交易，但拉起客户端后仍提示“订单不存在”，则更可能是客户端环境、沙箱账号或唤起跳转发生了混用。

第四步：检查手机端实际打开的应用

清理浏览器缓存，关闭正式版支付宝后重新测试，并确认：

打开的是沙箱测试客户端；
登录的是沙箱买家账号；
跳转过程没有被正式版支付宝接管；
没有复制旧支付链接重复测试；
没有通过会改写 URL 的中间页、短链或内嵌 WebView 跳转。

不同系统和客户端版本对 H5 唤起方式的处理可能不同。如果服务端订单确认有效，但只有特定客户端无法支付，需要结合当时的沙箱客户端能力和官方沙箱说明继续排查。不能仅凭“返回了 H5 页面”就认定服务端没有问题。

Java 配置示例

下面的示例包含沙箱 H5 支付所需的主要配置。实际密钥必须从对应的沙箱应用中获取。

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

AlipayTradeWapPayRequest request = new AlipayTradeWapPayRequest();
request.setReturnUrl("https://example.com/alipay/return");
request.setNotifyUrl("https://example.com/alipay/notify");

request.setBizContent("""
{
  "out_trade_no": "TEST202609090001",
  "total_amount": "0.01",
  "subject": "沙箱H5支付测试",
  "product_code": "QUICK_WAP_WAY"
}
""");

AlipayTradeWapPayResponse response = alipayClient.pageExecute(request);

if (response.isSuccess()) {
    String formHtml = response.getBody();
    // 将完整表单直接输出到浏览器，不要提取或拼接其中的跳转地址。
} else {
    System.err.println("subCode: " + response.getSubCode());
    System.err.println("subMsg: " + response.getSubMsg());
}

生成订单号时，应确保每次测试都使用新值，例如：

String outTradeNo =
    "TEST" + System.currentTimeMillis();

查询订单时，必须继续使用相同的沙箱客户端配置：

AlipayTradeQueryRequest queryRequest = new AlipayTradeQueryRequest();
queryRequest.setBizContent("""
{
  "out_trade_no": "TEST202609090001"
}
""");

AlipayTradeQueryResponse queryResponse =
    alipayClient.execute(queryRequest);

System.out.println(queryResponse.getCode());
System.out.println(queryResponse.getSubCode());
System.out.println(queryResponse.getSubMsg());
System.out.println(queryResponse.getTradeStatus());

注意事项

SDK 成功返回 HTML，不等于支付宝已经成功创建订单。
不要手动截取表单中的 URL 并重新拼接参数，应完整输出 SDK 返回的 HTML。
notify_url 必须能从公网访问，但异步通知无法到达通常不会直接导致付款页面提示“订单不存在”。
return_url 只负责同步跳转，不能单独用来判断支付是否成功。
支付结果应通过异步通知验签，并结合 alipay.trade.query 核实。
日志可以记录 app_id、网关、out_trade_no、接口返回码和 sub_code，但不能记录应用私钥、完整签名材料或买家密码。
修正配置后，应重新生成 out_trade_no 和支付页面，不要继续使用旧页面或旧链接。