「断线自动撤单」听上去像是一个布尔的开关,实际它取决于三层:客户端的 WebSocket 心跳、服务端的会话超时判定、以及订单本身的属性。四者组合出至少四种行为,其中最坏的一种是:你以为撤了,单子还在,还在被吃。
一、四种断连语义
| 模式 | 断连后的行为 | 风险 |
|---|---|---|
| 保持挂单 | 订单继续有效,直到被成交或手动撤 | 断线期间单子被吃,或方向反了却没人管 |
| 会话超时撤单 | 服务端发现会话超时后撤掉该会话下的单 | 超时窗口内仍有暴露;窗口多长通常不公开 |
| 仅撤标记订单 | 只撤带「断线撤单」标记的订单 | 忘记标记的单不受保护 |
| 仅撤衍生品仓位相关单 | 只对合约条件单生效,现货单不受影响 | 现货与合约行为不一致 |
这四种都不是「安全」或「不安全」,而是需要你知道自己处在哪一种。很多人以为自己开了「断线撤单」,实际上那个开关只对一种订单类型生效。
二、为什么服务端需要「超时判定」
客户端断网时,服务端并不知道你是「断网」还是「关掉了程序」。它只能靠心跳:一段时间收不到心跳就判定会话失效。这个超时窗口必须设得足够长,否则普通网络抖动就会误撤单;设得足够长,就意味着你的暴露时间也足够长。
这个算术的意义在于:断连风险与开仓量的平方根时间成正比,而不是与时间线性相关。所以缩短窗口的收益是递减的,而减少持仓敞口的收益是线性的——后者更有效。
三、六项核对清单
| # | 核对项 | 在哪里看 |
|---|---|---|
| 1 | 平台是否提供「断线撤单」开关,默认是开还是关 | API 文档 / 交易设置页 |
| 2 | 这个开关对哪些订单类型生效(现货、合约、条件单) | 文档的适用范围说明 |
| 3 | 会话超时窗口是多长,是否可配置 | API 文档 / 心跳参数 |
| 4 | 自己的程序是否发送心跳,间隔是多少 | 自己的代码与日志 |
| 5 | 断连后是否有本地记录与告警 | 程序日志、监控 |
| 6 | 恢复连接后是否先对账,再继续交易 | 启动流程 |
第 6 项最容易被跳过。恢复连接后如果直接继续发单,本地状态与服务端可能不一致,重复下单与幽灵仓位都由此产生。正确的顺序是:拉持仓、拉未成交订单、与本地记录逐条比对,再决定是否继续。
四、断连之后的三步动作
- 不要立刻重发订单。先确认服务端的真实状态,否则很容易变成重复下单。
- 用幂等键重试。带客户端订单 ID 的重试是安全的,不带的重试会制造重复订单。
- 检查保护性订单是否还在。止损单经常是「断连撤单」的对象,断连之后仓位可能处于无保护状态。
断连期间仓位可能处于无保护状态,行情剧烈波动时可能造成超出预期的亏损;合约仓位在极端行情下会被强制平仓。本文只讨论接口语义,不构成投资建议。
FAQ
问:开了「断线撤单」,为什么单子还在?
通常是三种原因:该开关只对特定订单类型生效;断连发生在会话超时判定之前,服务端还没认定你离线;或者该订单是通过另一个会话(例如网页端)下的,不在本次会话范围内。
问:心跳间隔设得很短是不是更安全?
不一定。间隔过短会被平台的频率限制判定为滥用,反而导致连接被断开。合理做法是略短于平台建议的超时窗口,并做好重连退避。
问:怎么验证自己的断连行为?
用小额订单做一次演练:挂一个远离市价的限价单,主动断网超过超时窗口,恢复后检查该单是否还在。演练过一次,比读十遍文档可靠。
相关阅读
来源与访问日期
2. 交易所 API 关于客户端订单 ID(幂等键)与重复下单判定的说明。访问日期 2026-10-29。
3. 本站旧文《幂等键、重复订单与三条重试规则》,用于交叉核对重试语义。访问日期 2026-10-29。