计算机网络 / 系统课时
网络抖动如何区分正常断开
网络抖动如何区分正常断开
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 等明确的策略或服务端错误,不应简单归类为网络抖动并立即无限重连。

推荐的分类顺序可以简化为:
- 客户端设置了“主动关闭”标记,并以
1000结束:按正常退出处理,不自动重连。 - 未主动关闭,但收到
1000或1001且wasClean=true:通常视为受控关闭,再由业务决定是否重连。 code=1006或wasClean=false:标记为未正常完成关闭握手,重点排查网络、代理、进程退出和超时。- 收到应用或服务端错误码:先处理鉴权、限流、服务异常等明确原因,再决定是否重连。
用一个处理器记录断开上下文
下面示例可直接放进浏览器页面运行。把 <PORT> 替换为实际 WebSocket 服务端口;实际 online、页面状态和最后消息时间会因运行环境不同而变化。
<!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>预期结果
当连接已建立、服务端正常回应关闭握手并点击“正常断开”时,核心字段应类似:
{
"classification": "client_normal",
"code": 1000,
"reason": "user logout",
"wasClean": true,
"readyState": 3,
"intentionalClose": true
}若直接断网、代理强制断开或服务进程消失,常见结果会进入 transport_or_unclean;具体 code、online 和心跳时间以浏览器实际事件为准。
记录这些字段才能真正排查
生产日志至少应带上连接标识、用户或会话的匿名标识、关闭时间、code、reason、wasClean、是否主动关闭、最近一次业务消息或心跳时间、当前重连次数以及客户端版本。服务端还应记录对应连接的握手结果、最后活跃时间和关闭原因,才能把“客户端看到异常断开”与“服务端为何失联”关联起来。
重连策略也应消费这套分类结果:主动退出不重连;短暂传输中断采用带抖动的退避;鉴权或策略错误先刷新凭证或停止重试;服务端内部错误则限制重试频率。这样网络抖动不会和正常退出混在同一条重连路径里。