支付宝预授权冻结接口提示 isp.unknow-error（系统繁忙）是什么问题？

2026-10-24支付老李

结论

isp.unknow-error（系统繁忙） 通常表示支付宝或其下游服务在处理预授权冻结请求时发生了未分类的内部异常，或者请求未能在规定时间内返回明确结果。

这个错误不代表冻结一定失败。遇到网络超时、网关异常等情况时，调用方可能收到了错误，但支付宝已经受理请求，甚至已经完成冻结。因此，不要直接发起一笔新的冻结，也不要立即把业务标记为失败。应保留原业务单号，先查询冻结结果，再决定是否重试或转人工处理。

可能原因

常见原因有以下几类：

支付宝服务短暂异常

支付宝网关、预授权服务或下游资金系统临时故障、负载过高或调用超时。这是该错误最常见的含义。
网络链路不稳定

商户服务器与支付宝网关之间发生连接中断、读取超时或代理异常。支付宝可能已经收到请求，只是响应没有正常返回。
请求触发了未明确归类的内部异常

某些参数组合、业务状态或账户配置问题，可能没有对应的具体业务错误，最终被统一映射为 isp.unknow-error。需要结合支付宝返回的 sub_code、sub_msg 和请求日志进一步判断。
同一业务单号被并发请求

多个线程或服务实例同时使用相同的 out_order_no、out_request_no 发起冻结，可能导致状态竞争。接口是否允许重复提交，以及重复提交时会返回什么结果，应以当前接口文档和实际响应为准。
业务配置或产品权限异常

例如预授权产品没有正确签约、应用与商户关系不匹配，或者支付授权码类型与业务场景不一致。这类问题通常会返回更具体的错误码，但部分链路异常也可能表现为系统繁忙。

签名错误、缺少必填参数、金额格式错误等问题，一般会返回明确的参数或验签错误。没有日志证据时，不要直接归因于参数问题。

排查和处理步骤

1. 保存完整请求与响应

至少记录以下信息：

API 名称，例如 alipay.fund.auth.order.freeze
out_order_no
out_request_no
请求时间
请求参数摘要
HTTP 状态码
code、msg
sub_code、sub_msg
支付宝返回的请求追踪标识（如果响应中存在）
SDK 异常类型和堆栈
网络超时信息

日志中不要明文保存完整授权码、私钥、应用密钥或其他敏感信息。

2. 判断结果是否未知

遇到以下情况，应将请求标记为结果未知：

返回 isp.unknow-error
请求读取超时
请求发出后连接中断
收到 HTTP 5xx
响应内容不完整或无法解析

在结果尚未确认时，不要更换业务单号重新冻结，否则可能产生重复冻结。

3. 使用原业务标识查询结果

调用支付宝提供的预授权操作查询接口，根据原冻结请求的业务单号查询最终状态。具体查询参数和状态字段，应以当前支付宝开放平台文档及项目使用的 SDK 版本为准。

处理逻辑可以概括为：

冻结请求返回成功
    -> 保存支付宝订单号和冻结状态

冻结请求返回明确业务失败
    -> 根据错误码修正业务或参数

冻结请求返回 isp.unknow-error、超时或网络异常
    -> 使用原 out_order_no / out_request_no 查询
        -> 查询到冻结成功：按成功处理
        -> 查询到明确失败：按失败处理
        -> 查询不到或状态仍不确定：延迟后继续查询

4. 确认未成功后再重试

只有在查询确认冻结未成功后，才考虑重试。重试时应满足以下条件：

保持相同的业务语义；
优先沿用原来的 out_order_no 和 out_request_no；
避免多个实例并发重试；
采用有次数限制的指数退避；
每次重试前或重试后查询最终状态；
超过限定时间仍无法确认时，转入人工处理。

能否使用同一业务单号直接重试，取决于该接口当前的幂等规则。不要为了绕过重复请求校验而不断生成新单号。

Java 处理示例

下面的示例主要展示异常处理思路。请求模型、SDK 类名和查询接口参数可能因支付宝 SDK 版本不同而有所差异，需要按照项目当前依赖调整。

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.response.AlipayFundAuthOrderFreezeResponse;

public class PreAuthService {

    private final AlipayClient alipayClient;

    public PreAuthService(AlipayClient alipayClient) {
        this.alipayClient = alipayClient;
    }

    public FreezeResult freeze(FreezeCommand command) {
        try {
            AlipayFundAuthOrderFreezeResponse response =
                    executeFreezeRequest(alipayClient, command);

            if (response.isSuccess()) {
                return FreezeResult.success(
                        command.getOutOrderNo(),
                        command.getOutRequestNo(),
                        response.getAuthNo()
                );
            }

            String subCode = response.getSubCode();
            String subMsg = response.getSubMsg();

            if ("isp.unknow-error".equalsIgnoreCase(subCode)) {
                // 不能直接判定冻结失败，应进入查询确认流程。
                return FreezeResult.unknown(
                        command.getOutOrderNo(),
                        command.getOutRequestNo(),
                        subCode,
                        subMsg
                );
            }

            // 这里只能表示支付宝返回了明确的失败响应。
            // 是否可以直接终止业务，还要结合具体错误码判断。
            return FreezeResult.failed(
                    command.getOutOrderNo(),
                    command.getOutRequestNo(),
                    subCode,
                    subMsg
            );
        } catch (AlipayApiException e) {
            // SDK 异常可能发生在请求发送前，也可能发生在请求发送后。
            // 在无法确定支付宝是否受理时，同样按结果未知处理。
            return FreezeResult.unknown(
                    command.getOutOrderNo(),
                    command.getOutRequestNo(),
                    "CLIENT_OR_NETWORK_EXCEPTION",
                    e.getMessage()
            );
        }
    }

    private AlipayFundAuthOrderFreezeResponse executeFreezeRequest(
            AlipayClient client,
            FreezeCommand command) throws AlipayApiException {
        // 按项目使用的支付宝 SDK 构造并执行
        // alipay.fund.auth.order.freeze 请求。
        throw new UnsupportedOperationException("Implement with the current Alipay SDK");
    }
}

对于结果未知的订单，可以通过定时任务或消息队列执行查询：

public void confirmUnknownFreeze(FreezeResult result) {
    QueryResult queryResult = queryFreezeOperation(
            result.getOutOrderNo(),
            result.getOutRequestNo()
    );

    switch (queryResult.getStatus()) {
        case SUCCESS:
            markFreezeSuccess(queryResult);
            break;
        case FAILED:
            markFreezeFailed(queryResult);
            break;
        case PROCESSING:
        case NOT_FOUND:
        case UNKNOWN:
            scheduleNextQuery(result);
            break;
        default:
            sendToManualReview(result);
    }
}

其中，QueryResult、scheduleNextQuery 等只是业务侧的示意代码，并非支付宝 SDK 提供的固定类或方法。

重试建议

查询可以采用有次数限制的指数退避，例如：

第 1 次查询：延迟 2 秒
第 2 次查询：延迟 5 秒
第 3 次查询：延迟 10 秒
第 4 次查询：延迟 30 秒
之后：降低查询频率或转人工处理

具体查询次数和间隔，应根据业务时效、接口限流规则及支付宝文档确定，不要无限循环重试。

注意事项

isp.unknow-error 表示当前调用结果不明确，不能直接视为确定失败。
重试时不要随意更换 out_order_no 或 out_request_no。
冻结、解冻、转支付等资金类操作，都应建立请求记录 -> 状态查询 -> 最终确认的处理闭环。
业务数据库应保存每次调用记录，并为同一业务单号设置唯一约束或分布式锁。
如果多次查询后仍无法确认结果，应携带请求时间、应用 ID、商户订单号、完整错误码和支付宝追踪标识，联系支付宝技术支持。
不要在日志、工单或聊天记录中暴露私钥、完整授权码及其他敏感凭证。
接口名称、查询字段、状态枚举和幂等规则可能随产品或 SDK 调整，应以当前支付宝开放平台文档为准。