计算机网络 / 系统课时

网络抖动如何区分正常断开

网络抖动如何区分正常断开

WebSocket 断开后,close 事件只能告诉你连接已经结束,不能单凭一个关闭码断言“就是网络抖动”。可靠做法是把关闭码、关闭握手是否完整、客户端是否主动退出、心跳时间和页面状态放在一起记录,再按固定顺序判断。

学习目标

  • 读懂 CloseEvent.code、reason、wasClean 与 readyState 能说明什么、不能说明什么。
  • 建立区分主动关闭、对端正常关闭和异常传输中断的判定顺序。
  • 记录足够的断开上下文,让重连策略和后续排障有依据。

先看浏览器真正提供的信号

浏览器触发 close 时,最有价值的是 code、reason 和 wasClean。其中 1000 表示正常关闭;1001 表示端点“离开”;1006 表示连接异常终止且没有收到正常 Close 帧,它是浏览器暴露给应用的保留状态,不会作为关闭码在网络上发送。

wasClean 只表示浏览器是否观察到规范的关闭握手,不能直接回答“根因是什么”。例如代理重启、Wi-Fi 切换、服务器进程崩溃都可能最终表现为 1006;反过来,一个带明确错误码的服务端关闭也可能完成了干净握手。

信号 更适合回答的问题 不应单独推出的结论
code 对端声明了哪类关闭语义 真实网络根因
wasClean 关闭握手是否完整 业务是否正常
主动关闭标记 是否由本客户端明确发起 对端是否健康
最近心跳/消息时间 断开前是否已有静默迹象 哪一层设备故障
navigator.onLine 浏览器是否认为存在网络连接 Internet 一定可达

建立可解释的判定顺序

先判断客户端是否明确执行了退出;再检查关闭码和 wasClean;最后结合心跳、在线状态、页面可见性与重试次数解释“更像哪类问题”。对于 1008、1011 等明确的策略或服务端错误,不应简单归类为网络抖动并立即无限重连。

WebSocket 断开原因判定流程

推荐的分类顺序可以简化为:

  1. 客户端设置了“主动关闭”标记,并以 1000 结束:按正常退出处理,不自动重连。
  2. 未主动关闭,但收到 1000 或 1001 且 wasClean=true:通常视为受控关闭,再由业务决定是否重连。
  3. code=1006 或 wasClean=false:标记为未正常完成关闭握手,重点排查网络、代理、进程退出和超时。
  4. 收到应用或服务端错误码:先处理鉴权、限流、服务异常等明确原因,再决定是否重连。

用一个处理器记录断开上下文

下面示例可直接放进浏览器页面运行。把 <PORT> 替换为实际 WebSocket 服务端口;实际 online、页面状态和最后消息时间会因运行环境不同而变化。

html
<!doctype html>
<meta charset="utf-8">
<button id="disconnect">正常断开</button>
<pre id="log"></pre>
<script>
const ws = new WebSocket("ws://localhost:<PORT>/ws");
const log = document.querySelector("#log");
let intentionalClose = false;
let lastMessageAt = null;

function classifyClose(event) {
  if (intentionalClose && event.code === 1000) return "client_normal";
  if ((event.code === 1000 || event.code === 1001) && event.wasClean) {
    return "peer_controlled";
  }
  if (event.code === 1006 || !event.wasClean) return "transport_or_unclean";
  return "server_or_policy";
}

ws.addEventListener("message", () => {
  lastMessageAt = Date.now();
});

ws.addEventListener("close", (event) => {
  const context = {
    classification: classifyClose(event),
    code: event.code,
    reason: event.reason,
    wasClean: event.wasClean,
    readyState: ws.readyState,
    intentionalClose,
    online: navigator.onLine,
    visibility: document.visibilityState,
    msSinceLastMessage:
      lastMessageAt === null ? null : Date.now() - lastMessageAt
  };

  log.textContent = JSON.stringify(context, null, 2);
  console.log("websocket-close", context);
});

document.querySelector("#disconnect").addEventListener("click", () => {
  if (ws.readyState !== WebSocket.OPEN) return;
  intentionalClose = true;
  ws.close(1000, "user logout");
});
</script>

预期结果

当连接已建立、服务端正常回应关闭握手并点击“正常断开”时,核心字段应类似:

json
{
  "classification": "client_normal",
  "code": 1000,
  "reason": "user logout",
  "wasClean": true,
  "readyState": 3,
  "intentionalClose": true
}

若直接断网、代理强制断开或服务进程消失,常见结果会进入 transport_or_unclean;具体 code、online 和心跳时间以浏览器实际事件为准。

记录这些字段才能真正排查

生产日志至少应带上连接标识、用户或会话的匿名标识、关闭时间、code、reason、wasClean、是否主动关闭、最近一次业务消息或心跳时间、当前重连次数以及客户端版本。服务端还应记录对应连接的握手结果、最后活跃时间和关闭原因,才能把“客户端看到异常断开”与“服务端为何失联”关联起来。

重连策略也应消费这套分类结果:主动退出不重连;短暂传输中断采用带抖动的退避;鉴权或策略错误先刷新凭证或停止重试;服务端内部错误则限制重试频率。这样网络抖动不会和正常退出混在同一条重连路径里。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

网络抖动如何区分正常断开

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通