下单超时之后再点一次:幂等键、重复订单与三条重试规则

导语:请求超时了,你不知道单子成没成。这时再点一次「买入」,最坏的结果是两倍仓位——而且两笔都合法存在。

一、超时不等于失败

网络层超时只说明你没收到响应,不说明服务器没执行。常见的三种结局:已成交、已受理在排队、根本没到服务器。客户端凭「超时」做的任何推断,都有一半概率是错的。

这就是为什么下单接口要配一个幂等键——由你生成、可以重复提交、服务器见一次执行一次。

二、幂等键怎么用

做法 实现 效果 常见错误
自建订单号 提交时带 clientOrderId 同号只受理一次 每次重试换新号
先查后发 按 clientOrderId 查询再决定 避免重复下单 查询条件用成交号
本地状态机 记录已提交的号与结果 重启后仍能续上 只存在内存里

三、重试的三条硬规则

第一,同一个业务意图只用一个号,重试不换号。第二,超时后先按号查询,查到就收下结果,不要补发。第三,网络错误可以重试,业务错误(余额不足、参数非法)重试没有意义,只会刷出一堆废单。

更细一层:部分平台对重复的 clientOrderId 返回错误码而不是原订单,这时要能区分「已存在」与「参数错误」,否则你会以为单子丢了。

四、幂等键不能解决什么

它管的是同一笔意图的重复提交,管不了「你手滑点了两次但用了两个号」。所以客户端还要有去重:按钮锁定、请求中禁止再次提交、订单列表按时间倒序看最近一笔。

它也管不了撮合侧的部分成交:一笔订单可能分多次成交,重试逻辑要按订单状态(未成交、部分成交、全部成交、已撤)判断,而不是按成交笔数。

五、一个最小可用的重试流程

生成号 → 提交 → 超时 → 按号查询 → 有结果则记录;无结果则等一小段退避时间再查 → 连续查不到才判失败并允许人工介入。全程只发一次下单请求,查询可以无限次,这样最坏情况是少下一单,而不是多下一单。

问:重试时换一个新的 clientOrderId 会怎样?

答:服务器会当成两笔新订单,可能出现双倍仓位。幂等的意义就在号不变,换号等于放弃保护。

问:查询也超时怎么办?

答:先退避再查,多次查不到再判失败。不要用「再下一单」来验证上一单是否存在。

问:幂等能防止重复成交吗?

答:不能。它只防重复提交,部分成交是撮合的正常行为,要按订单状态而不是成交笔数判断。

本文为接口可靠性说明,不构成投资建议;错误码与去重窗口以平台 API 文档为准。

来源与日期:幂等下单与订单查询的语义依据公开交易所 API 文档口径(clientOrderId 唯一性与重试行为),访问日期 2026-10-28;具体错误码以平台文档为准。

相关阅读

安装 App