计算机网络 / 系统课时
关闭码怎样表达连接原因
关闭码怎样表达连接原因
WebSocket 的关闭不是简单断开 TCP。规范通过 Close 控制帧携带关闭码和可选原因,让双方区分正常离开、协议错误、数据不合法和服务端异常。本节建立一套可落地的关闭处理规则,避免把所有断线都当成同一种错误。
学习目标
- 能区分常见标准关闭码及不能主动发送的保留码。
- 能理解正常关闭握手与异常断开的差别。
- 能为客户端重连、提示和服务端记录建立一致的处理规则。
关闭不是直接断 TCP
正常关闭通常由一端先发送 Close 帧;另一端收到后,如果自己还没有发送 Close,应回送 Close。双方都完成 Close 的发送与接收后,再结束底层 TCP 连接。这样应用才能知道“对方为什么关闭”,而不是只看到一个网络连接消失。

Close 帧的 Payload 为空时,表示没有携带状态码;非空时前 2 字节是状态码,后面可以跟 UTF-8 原因文本。原因文本适合给日志或调试使用,不应承载必须由程序解析的大段业务数据。
常用关闭码怎么选
标准关闭码表达的是连接层语义,不应拿来随意替代业务错误码。实际开发最常见的是下面这些。
| 关闭码 | 含义 | 典型处理 |
|---|---|---|
1000 |
正常关闭 | 不告警;是否重连由业务场景决定 |
1001 |
端点离开 | 常见于服务停机、页面离开;可按策略重连 |
1002 |
协议错误 | 停止当前连接,记录协议解析或实现问题 |
1003 |
不接受当前数据类型 | 检查文本/二进制消息约定 |
1007 |
数据内容不合法 | 常见于文本消息不是合法 UTF-8 |
1008 |
违反策略 | 按服务端策略处理,通常不立即无条件重试 |
1009 |
消息过大 | 调整消息大小、分片或服务端限制 |
1011 |
服务端遇到意外情况 | 记录服务异常,可采用退避重连 |
1005、1006 和 1015 是保留状态,不能作为 Close 帧中的发送码。尤其 1006 表示“连接异常结束且没有收到正常 Close 帧”,它是本地观察结果,不是对端发来的关闭原因。
应用若需要自定义连接级语义,可在 4000~4999 私有使用区间定义约定,例如“登录态过期”或“同账号被顶下线”。3000~3999 适合由库、框架或应用按登记规则使用,团队不要把两类区间混成无约束的数字池。
客户端和服务端怎样定规则
关闭处理应把“协议事实”和“业务动作”分开。服务端负责发送尽可能准确的 Close 码并记录原因;客户端根据关闭码决定是否静默结束、提示用户、刷新凭证或退避重连。
| 场景 | 服务端建议 | 客户端建议 |
|---|---|---|
| 用户主动退出 | 1000,原因简短 |
不自动重连 |
| 服务滚动重启 | 1001 |
延迟后重连,避免瞬时风暴 |
| 收到非法帧 | 1002 |
停止重试并上报版本、协议上下文 |
| 单条消息超过限制 | 1009 |
缩小消息或调整发送策略 |
| 服务端内部异常 | 1011 |
指数退避重连并记录失败次数 |
| 登录态失效 | 约定的 4xxx |
刷新凭证或重新登录后再连接 |
自定义关闭码要写进客户端和服务端共享协议文档,并保持稳定。原因文本只用于补充说明,长度应尽量短,也不要放令牌、用户隐私或堆栈等敏感信息。
浏览器里怎样读取关闭结果
片段示例:下面代码依赖当前页面中已经创建并成功连接的 ws 对象,只演示如何统一读取 CloseEvent;它不能单独运行。
function decideAction(event) {
if (event.code === 1000) return "stop";
if (event.code === 1001 || event.code === 1011) return "retry-with-backoff";
if (event.code >= 4000 && event.code <= 4999) return "handle-app-policy";
return "report-and-stop";
}
ws.addEventListener("close", (event) => {
console.log({
code: event.code,
reason: event.reason,
wasClean: event.wasClean,
action: decideAction(event)
});
});其中 code 是观察到的关闭状态,reason 是对端 Close 帧中的可选原因文本,wasClean 表示用户代理是否认为连接完成了干净关闭。网络中断时常见 code=1006,这时不要尝试“回发 1006”。
异常断开要单独处理
如果 TCP 被重置、网络突然消失、进程崩溃或代理直接切断连接,双方可能根本没有机会交换 Close 帧。此时客户端只能确认“连接异常结束”,不能凭空推断服务端原本想表达的业务原因。
因此重连策略不要只看“连接断了没有”,还要同时看关闭码、是否收到原因、失败次数以及业务状态。正常 1000 通常不应自动重连;1001、1011 可以退避后重试;1002 这类协议错误若持续重连,往往只会制造循环故障。