结论

启用“接口内容加密方式”后，应用端仍然需要完成相应配置。这个功能通常意味着平台会加密接口中的敏感业务内容，或要求应用具备解密能力。签名、验签、AES 密钥配置和请求参数处理依然要正确完成。

如果沙箱环境开启该功能后立即无法支付，常见原因是应用没有配置接口内容加密密钥，或者代码使用的密钥、加密算法与沙箱应用后台的配置不一致。

为什么会影响支付流程

接口签名和内容加密是两套独立的机制：

• RSA2 等签名算法用于确认请求来源，并检查数据是否被篡改。
• AES 等内容加密算法用于保护接口中的业务数据。
• 签名密钥不能代替内容加密密钥。
• 开启内容加密后，原有的签名和验签逻辑仍需保留。

“开启后无需额外处理”通常有一个前提：当前使用的 SDK 支持内容加解密，而且应用已经把正确的加密密钥传给 SDK。SDK 可以替业务代码完成加解密，但无法自动获取应用后台配置的密钥。

如果只在后台开启功能，没有同步修改代码配置，请求构造、响应解析或异步通知处理仍可能失败。具体表现可能是支付页面无法打开、下单失败或支付结果处理异常。

解决步骤

1. 核对沙箱应用的加密配置

进入对应的沙箱应用配置，逐项确认：

• 是否已经启用“接口内容加密方式”。
• 使用的是哪种加密算法。
• 当前生效的是哪一把接口内容加密密钥。
• 代码连接的 appId 是否属于这个沙箱应用。
• 沙箱配置是否误用了正式环境的密钥。

接口内容加密密钥、应用私钥和平台公钥各有用途，不能混用。

2. 将加密密钥配置到 SDK

以常见的 Java SDK 初始化方式为例，最后一个参数通常用于传入接口内容加密密钥：

AlipayClient alipayClient = new DefaultAlipayClient(
    gatewayUrl,
    appId,
    appPrivateKey,
    "json",
    "UTF-8",
    alipayPublicKey,
    "RSA2",
    encryptKey
);

各参数的用途如下：

appPrivateKey     应用私钥，用于签名
alipayPublicKey   支付平台公钥，用于验签
encryptKey        接口内容加密密钥，用于内容加解密

encryptKey 必须与当前沙箱应用后台配置的密钥一致。不要在这里填入应用私钥、公钥证书内容或平台公钥。

不同语言、不同版本 SDK 的构造参数可能有所区别，应以实际使用的 SDK 接口为准。如果当前 SDK 没有加密密钥配置项，需要确认该版本是否支持接口内容加密。

3. 检查请求方式

使用官方 SDK 时，应由 SDK 完成请求签名、内容加密和响应解析，不要再次加密 biz_content。

示例：

AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();

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

AlipayTradePagePayResponse response = alipayClient.pageExecute(request);

如果绕过 SDK，自行拼装 HTTP 请求，则必须严格按照平台协议完成以下处理：

1. 序列化业务参数。
2. 使用规定的算法和密钥加密指定内容。
3. 对最终参与签名的参数排序并签名。
4. 正确进行 URL 编码。
5. 收到响应后先验签，再按协议解密。

其中任何一步出现编码、填充方式、字符集或参数顺序不一致，都可能使请求失败。

4. 同时检查同步响应和异步通知

能够发起支付请求，不等于整个支付流程都已正确配置。

开启内容加密后，还需要确认：

• SDK 能否正常解析接口响应。
• 支付完成后的异步通知能否通过验签。
• 通知中需要解密的字段是否使用同一把密钥。
• 解密失败时，业务代码是否误将订单判定为支付失败。
• 回调接口是否返回平台要求的成功响应。

排查时，最好把“下单失败”“收银台无法打开”和“支付成功但订单未更新”分开处理，因为它们通常发生在不同环节。

建议记录的错误信息

排查时应保留以下信息，但不要记录私钥或完整的加密密钥：

appId
接口名称
网关地址
sign_type
charset
SDK 版本
平台返回的 code
平台返回的 sub_code
平台返回的 sub_msg
本地验签或解密异常堆栈

仅凭“无法支付”无法判断问题出在网关拒绝请求、响应解密失败，还是异步通知处理失败。sub_code、sub_msg 和本地异常通常能提供更明确的线索。

注意事项

• 沙箱环境和正式环境的应用配置通常相互独立，不要交叉使用密钥。
• 更换或重新生成加密密钥后，也要同步更新应用配置。
• 不要将接口内容加密密钥提交到 Git 仓库，建议通过环境变量或密钥管理服务注入。
• 不要在日志中输出应用私钥、完整 AES 密钥或解密后的敏感数据。
• 使用证书模式时，签名证书配置和内容加密配置仍然是两回事。
• 如果暂时关闭内容加密后支付恢复正常，可以将排查范围缩小到加密密钥、SDK 支持情况和加解密处理，但不能仅凭这一点认定平台存在异常。

“无需额外处理”是指 SDK 可以自动完成加解密，并不意味着应用端无需配置密钥。后台开关和客户端配置必须配套，否则内容加密会直接影响支付链路。

备注：内容仅供参考。