股票 WebSocket 行情实战：解决停牌复牌 K 线断层，完整快照修复方案

前言

最近在做量化行情终端开发时踩了一个典型业务坑：个股停牌后复牌，K线出现明显时间空白断层，量化回测指标全部失真。

最开始我的实现逻辑很粗暴：只要长时间没有Tick推送，就判定接口断连，频繁重连WebSocket、批量拉取历史K线补数据。上线后不仅请求量暴涨、带宽浪费，还出现大量重复快照记录，数据校验报错频发。

经过多轮调试，我找到一套标准化解决方案：基于WebSocket订阅指令，解析报文自带的交易状态字段，单连接动态管理订阅，无需重建连接、不虚构停牌成交数据，自动修复停牌到复牌的完整时序快照。下文完整分享落地思路、踩坑点、可直接运行的Python代码。

一、核心概念说明

停牌复牌快照恢复定义

个股复牌第一条Tick到达后，读取本地持久化的停牌状态缓存，校验停牌区间历史快照完整性，仅补充交易状态标记，串联停牌前静态价格快照与复牌实时数据流。

和两种低效方案做区分：

1. 不销毁重建WebSocket连接，避免重连风暴；
2. 不依赖定时REST轮询拉取全量历史K线。

二、业务场景与参数复核对照表

应用场景	开发痛点	订阅配置（cmd_id/action/code）	校验标准
初始订阅包含停牌个股	无法区分接口掉线/个股停牌，误判数据丢失	cmd_id=22004，action=subscribe，解析status字段	WS连接就绪后缓存标的交易状态
盘中临时停牌	无Tick推送就频繁重连，造成大量短连接	保持单连接持续订阅，识别suspend停牌标识	本地记录停牌区间，留存停牌前最新价格
长期停牌后复牌	复牌数据直接入库，时序缺口导致K线断裂	复用原有WS连接，触发快照修复流程	匹配停牌起止时间，补全时序状态记录
重复订阅停牌标的	重复下发指令，数据库快照冗余	订阅前本地集合去重拦截上行请求	缓存校验已订阅标的，避免重复指令
网络断连恰逢个股复牌	重连丢失停牌状态，前后行情无法衔接	重连自动恢复订阅，批量查询标的基础状态	重连完成主动校验历史快照完整性

三、开发高频踩坑总结（4类线上典型问题）

1. 停牌无Tick直接判定数据丢失，循环调用历史接口

现象 ：个股停牌期间无成交报文，程序无限循环拉取批量K线接口，消耗接口额度。

检测方式 ：解析每条Tick内置status字段，区分「交易暂停」和「链路异常断开」两种空白区间。

解决方案：仅status为正常交易且长期无数据时，才执行重连；停牌状态下停止历史数据补拉逻辑。

2. 复牌Tick入库未关联停牌记录，时序链条断裂

现象 ：数据库仅存在停牌前快照、复牌首条Tick，中间时间段无状态记录，图表出现缺口。

检测方式 ：查询标的完整时间轴，对比复牌时间与停牌结束时间是否连续。

解决方案：独立存储表记录每只个股停牌起止时间、停牌前收盘价；复牌数据入库时关联该表写入时序标记。

3. 多标的同步复牌，并行修复引发数据库写入竞态

现象 ：多只股票同日复牌，多线程并行执行修复逻辑，同一标的生成多条重复停牌记录。

检测方式 ：统计同一code+同一停牌周期下的数据条数，出现多条重复条目。

解决方案：单标的快照修复逻辑串行执行，数据库设置code+停牌起始时间联合唯一索引。

4. 品类地址混用，停牌状态字段无法解析

现象 ：股票标的使用加密货币WSS地址订阅，报文无status字段，无法识别停牌/复牌。

检测方式 ：核对接入域名，股票必须使用独立专用WebSocket地址。

解决方案：代码层做品类路由隔离，股票请求强制路由至股票专用WSS地址，拦截跨品类错误请求。

四、方案边界说明

本方案基于标准订阅指令cmd_id=22004实现，支持单条活跃WebSocket连接内动态增删标的、修复停牌时序；存在两处限制：

1. 无法跨多条WebSocket连接同步个股停牌状态；
2. 不会自动生成停牌期间模拟成交Tick，仅补充交易状态标记字段，不支持虚构行情数据。

五、完整可运行Python代码

import websockets
import asyncio
import json
from datetime import datetime

# 股票行情专用WSS地址，参考官方接口文档
WSS_STOCK_URL = "wss://quote.alltick.co/quote-stock-b-ws-api?token=YOUR_TOKEN"

class StockQuoteClient:
    def __init__(self):
        self.ws = None
        self.subscriptions = set()
        # 本地缓存：key=股票code，存储停牌时间、停牌前价格、交易状态
        self.stock_status_cache = {}

    async def send_subscribe(self, action: str, code_list: list):
        if not code_list:
            return
        payload = {
            "cmd_id": 22004,
            "action": action,
            "code": code_list
        }
        await self.ws.send(json.dumps(payload))
        if action == "subscribe":
            [self.subscriptions.add(c) for c in code_list]
        elif action == "unsubscribe":
            [self.subscriptions.discard(c) for c in code_list]

    def check_resume_repair(self, code: str, curr_status: str, trade_time: str):
        """检测个股复牌，触发快照时序修复核心逻辑"""
        cache_info = self.stock_status_cache.get(code)
        if not cache_info:
            return
        old_status = cache_info["status"]
        # 状态从停牌切换为正常交易，判定为复牌
        if old_status == "suspend" and curr_status == "normal":
            print(f"标的{code}复牌，启动历史快照时序校验")
            self.repair_snapshot_timeline(code, cache_info["suspend_start"], trade_time)
            self.stock_status_cache[code]["status"] = "normal"

    def repair_snapshot_timeline(self, code, suspend_start, resume_time):
        """模拟时序修复，持久化停牌区间状态记录"""
        repair_record = {
            "code": code,
            "suspend_start": suspend_start,
            "resume_time": resume_time,
            "pre_suspend_price": self.stock_status_cache[code]["last_price"],
            "status": "suspend_repaired"
        }
        # save_market_snapshot(repair_record) 此处替换为自己的持久化逻辑
        print("已写入停牌区间时序修复记录", repair_record)

    async def on_open(self):
        # 初始化订阅标的
        init_codes = ["NASDAQ:AAPL", "HKEX:00700"]
        await self.send_subscribe("subscribe", init_codes)
        print("股票WebSocket连接建立，完成初始标的订阅")

    async def on_message(self, raw_msg):
        if not raw_msg:
            return
        try:
            data = json.loads(raw_msg)
            tick_data = data.get("data", {})
            code = tick_data.get("code")
            price = tick_data.get("price")
            trade_time = tick_data.get("time")
            status = tick_data.get("status", "normal")

            # 空值守卫，过滤无效行情报文
            if not code or price in (None, 0) or not trade_time:
                return

            # 更新本地标的状态缓存
            if code not in self.stock_status_cache:
                self.stock_status_cache[code] = {}
            self.stock_status_cache[code]["last_price"] = price
            self.stock_status_cache[code]["status"] = status
            if status == "suspend" and "suspend_start" not in self.stock_status_cache[code]:
                self.stock_status_cache[code]["suspend_start"] = trade_time

            # 校验是否触发复牌修复逻辑
            self.check_resume_repair(code, status, trade_time)
            print(f"行情更新 | {code} 价格:{price} 交易状态:{status}")
        except Exception as e:
            print("行情报文解析异常", str(e))

    async def on_error(self, err):
        print("WebSocket连接异常：", err)

    async def on_close(self):
        print("股票WebSocket连接关闭")

    async def connect(self):
        try:
            async with websockets.connect(
                WSS_STOCK_URL,
                ping_interval=10
            ) as ws:
                self.ws = ws
                await self.on_open()
                while True:
                    msg = await ws.recv()
                    await self.on_message(msg)
        except Exception as e:
            await self.on_error(e)
            await self.on_close()

async def run_demo():
    client = StockQuoteClient()
    task = asyncio.create_task(client.connect())
    await task

if __name__ == "__main__":
    asyncio.run(run_demo())

总结

对于量化回测、金融终端这类对数据连续性要求严苛的业务，停牌复牌的数据衔接是极易被忽略但影响极大的细节。完整解决方案需要三层逻辑配合：实时数据流状态监听、本地标的状态缓存、历史快照时序校验，才能彻底规避K线断层、指标计算失真等线上问题。

如果需要快速搭建覆盖股票、外汇、贵金属、加密货币全品类的标准化行情服务，AllTick API 统一规范的WebSocket订阅报文、完善的多语言示例代码，能够大幅降低特殊交易场景的适配与调试成本。