WebSocket 报 1006 异常断开 心跳和重连怎么配

现象

前端 WebSocket 连上几分钟后断开,onclose 里拿到 code 1006,reason 是空字符串。页面没有任何提示,需要手动刷新才能恢复,服务端日志里也看不到正常的关闭握手记录,看起来像是连接凭空消失。

原因

1006 表示连接异常关闭,是浏览器给出的本地状态码,不会出现在网络帧里,通常意味着没有收到关闭帧。常见原因是中间代理的空闲超时、手机网络切换、服务端进程被杀。浏览器不会自动重连,必须由业务代码实现。

解决步骤

第一步,在 onclose 里做指数退避重连。设置次数上限,避免服务端故障时前端疯狂打请求把问题放大。

let retry = 0;
function connect() {
  const ws = new WebSocket("wss://api.example.com/ws");
  ws.onclose = (e) => {
    if (e.code === 1006 || e.code === 1001) {
      const wait = Math.min(30000, 1000 * 2 ** retry++);
      setTimeout(connect, wait);
    }
  };
  ws.onopen = () => { retry = 0; };
  return ws;
}

第二步,加应用层心跳。每 30 秒发一次 ping,超过 60 秒没收到 pong 就主动 close,让流程进入重连分支,避免连接假死还占着界面上的在线状态。

第三步,排查代理超时。Nginx 的 proxy_read_timeout 默认 60 秒,长连接场景要调大,并配置 proxy_http_version 1.1 与 Upgrade 头,否则升级后的连接会被网关直接掐断。

验证

断网 10 秒再恢复,观察 Network 面板里是否自动重连;把服务端进程重启一次,前端应在几十秒内恢复推送,重连间隔呈递增趋势而不是固定高频。

小结

1006 是本地异常码,说明没收到正常关闭帧。退避重连加应用层心跳解决客户端问题,再检查代理超时,长连接才能长时间稳定在线。

您可以还会对下面的文章感兴趣: