稳定 websocket 长连接需心跳保活、智能重连与状态兜底三者结合:客户端每30秒发ping,服务端回pong,超时60秒判失联;重连采用指数退避(1s→2s→4s…),限5次且间隔≤30秒;校验readystate并配合心跳反馈构建准确状态机。

建立一个稳定的 WebSocket 长连接,光靠 new WebSocket(url) 是不够的。原生连接缺乏自动重连、状态感知和保活能力,网络抖动、Nginx 代理超时、移动网络切换等场景下极易静默断开。真正稳定的关键,在于**心跳保活 + 智能重连 + 状态兜底**三者结合。
主动发送心跳包,防止中间件“砍连接”
防火墙、Nginx(默认 proxy_read_timeout 60s)、运营商 NAT 网关通常会在空闲 30–120 秒后主动断连。必须定期发数据“打招呼”。
- 推荐客户端每 30 秒 发一次
"PING"(字符串或简单 JSON),服务端收到后应立即回"PONG" - 同时设置响应超时,例如 60 秒内未收到 PONG 就判定失联,避免假连接
- 注意:不要只依赖服务端单向心跳——若服务端宕机但连接未断开,客户端无法感知;双向探测更可靠
实现带指数退避的自动重连
onclose 或心跳超时后不能立刻重连,否则可能压垮服务端或触发限流。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 首次失败后等待 1 秒,第二次失败等 2 秒,第三次等 4 秒……按 2 的幂次递增
- 设定最大重试次数(如 5 次)和上限间隔(如不超过 30 秒),避免无限循环
- 重连前检查
navigator.onLine,断网时不盲目重试;重连成功后重新发送鉴权或同步状态
封装连接状态与 readyState 校验
原生 readyState 并非实时准确,比如连接已断但状态仍显示 OPEN。需配合心跳反馈做二次判断。
- 发送消息前务必检查
ws.readyState === WebSocket.OPEN,否则会静默失败 - 自定义连接状态机:如
CONNECTING→OPEN→HEARTBEATING→RECONNECTING,便于监控和调试 - 所有
send()调用建议包装成队列,在重连恢复后自动补发未送达消息(可选增强)
用 websocket-heartbeat-js 快速落地(推荐)
不必从零造轮子。该库已集成心跳、超时检测、重连、事件钩子等能力,轻量无依赖:
- 安装:
npm install websocket-heartbeat-js - 使用:
const ws = new WebsocketHeartbeatJs({ url: 'wss://api.example.com/ws', timeout: 60000, heartbeat: 30000 }) - 它自动处理
onopen/onmessage/onreconnect,你只需专注业务逻辑
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










