加密货币实战：WebSocket 订阅总超时断开？一文教你稳定解决

大家在做加密货币行情看板、量化交易机器人、实时价格监控时，几乎都会遇到一个超头疼的问题：WebSocket 连接动不动就超时、断开、重连失败，尤其是网络波动、服务器空闲、心跳异常时，行情直接中断，程序直接 “卡死”。

这篇慕课手记就用最简单、最实战、最适合练手与项目上线的方式，带你一步步定位原因、写出稳定重连机制，让你的加密货币实时数据7×24 小时不断线。

一、先搞懂：为什么 WebSocket 会断？

在加密货币实时 API 场景里，断开基本就这 4 个原因：

1. 长时间没消息，网关 / 防火墙直接切断空闲连接

2. 缺少心跳包，服务端认为客户端已下线主动关闭

3. 网络闪断、代理波动，客户端没做自动重连

4. 并发订阅太多，服务端限流或触发保护机制

不是你的代码烂，而是长连接本身就需要保活机制。

二、最容易踩的 3 个坑（新手必看）

• 只写连接逻辑，完全不处理断开

• 收到 close/error 事件不重连，断了就彻底凉

• 重连不加退避策略，一断就疯狂重连炸服务

只要补上一套心跳 + 监听 + 智能重连，问题基本全解决。

三、实战核心：稳定不断的 WebSocket 模板（直接复制）

下面这套结构是我项目里一直在用的生产级极简模板，你只要替换地址和订阅内容就能跑。

import json
import time
import websocket
from threading import Timer

# 全局配置
WS_URL = "wss://你的加密货币API地址"
RECONNECT_INTERVAL = 3  # 重连间隔秒
HEARTBEAT_INTERVAL = 10 # 心跳间隔

def on_message(ws, message):
    # 处理实时行情
    tick = json.loads(message)
    print(tick)

def on_error(ws, error):
    print("错误:", error)

def on_close(ws, close_code, reason):
    print("断开，准备重连...")
    # 断开后自动重连
    time.sleep(RECONNECT_INTERVAL)
    start_websocket()

def on_open(ws):
    print("连接成功")
    # 订阅行情
    ws.send(json.dumps({
        "action": "subscribe",
        "symbols": ["btcusdt", "ethusdt"]
    }))
    # 启动心跳
    start_heartbeat(ws)

# 心跳保活
def start_heartbeat(ws):
    def heartbeat():
        while True:
            time.sleep(HEARTBEAT_INTERVAL)
            if ws.sock and ws.sock.connected:
                ws.send(json.dumps({"action": "ping"}))
    Timer(0, heartbeat).start()

# 启动入口
def start_websocket():
    ws = websocket.WebSocketApp(WS_URL)
    ws.on_message = on_message
    ws.on_error = on_error
    ws.on_close = on_close
    ws.on_open = on_open
    ws.run_forever()

if __name__ == "__main__":
    start_websocket()

四、让连接更稳的 4 个小技巧（实战总结）

1. 必须加心跳：ping/pong 是长连接生命线

2. 断开必重连：on_close 里统一触发重连逻辑

3. 重连加间隔：不要死循环瞬间爆请求

4. 订阅不要贪多：分批订阅，避免被限流

做到这 4 点，你的 WebSocket 基本很难再断。

五、总结

加密货币实时 API 的 WebSocket 超时断开，是长连接的正常现象，不是 BUG。只要用一套心跳保活 + 自动重连 + 错误监听的标准结构，就能轻松解决。

在实际项目中，AllTick API 提供稳定、低延迟的加密货币实时行情，配合上面这套重连机制，不管是课程作业、个人练手还是小项目上线，都能稳稳运行、不断线。