服务端必须发送标准Close帧才能真正断开WebSocket连接，仅调用close()不等于连接终结；需先确认连接处于OPEN状态，再发送含规范状态码的Close帧，等待对端响应或超时后清理资源。
服务端主动调用 close() 才算真正断开
websocket 服务端不能靠“不发消息”或“关闭 socket 文件描述符”来结束连接——必须发送标准 close 帧。否则客户端会卡在 closing 状态，服务端资源不释放，甚至触发重连风暴。
不同框架的关闭方式本质一致：先构造并发送关闭帧（含状态码），再等待对端响应（可设超时），最后清理本地连接对象。
-
FastAPI中用websocket.close(code=1000, reason="正常关闭")，它会自动处理帧交换和状态迁移 -
gorilla/websocket（Go）需显式调用conn.WriteMessage(websocket.CloseMessage, websocket.FormatCloseMessage(websocket.CloseNormalClosure, "ok"))，再调conn.Close() -
ws（Node.js）直接ws.close(1000, "bye")即可，库已封装握手逻辑 - Python
websockets库推荐用await websocket.close(code=1000, reason="done")，内部会等对方 ACK 或超时后强制终止
close() 调用后必须等响应或超时，不能立刻销毁上下文
调用 close() 只是发起关闭握手，不是连接终结的终点。服务端仍需监听对方返回的 Close 帧，或等待超时才可安全释放内存、取消定时器、解绑事件。
常见错误是：一调 close() 就立刻从连接池中移除 websocket 对象，结果对方还没收到关闭帧，后续消息仍被路由过去，引发 ConnectionClosedOK 异常或数据丢失。
- FastAPI 中应在
except WebSocketDisconnect:块里做清理，而不是在close()后立刻执行 - Python
websockets库中，close()返回一个asyncio.Task，建议await它完成，或至少用asyncio.wait_for(close_task, timeout=5) - Go 的
gorilla/websocket默认不阻塞，需手动调conn.ReadMessage()检查是否收到对方的Close帧，或依赖SetReadDeadline控制等待窗口
关闭前必须检查 readyState 或底层连接是否还活跃
服务端主动关连接前，得确认它还在 OPEN 状态。若连接已因网络中断进入 CLOSED，再调 close() 会抛异常（如 FastAPI 的 RuntimeError: Already closed），或静默失败。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
尤其在心跳检测、闲置踢出等场景下，不能仅凭定时器触发就无条件关——要先验证连接是否真实可用。
- FastAPI：
if websocket.client_state == WebSocketState.CONNECTED:再关（注意不是websocket.application_state） - Python
websockets：if websocket.open:是最简判断，但更稳妥的是捕获ConnectionClosed异常后再跳过关闭逻辑 - Go：
if conn.State() == websocket.Connected，否则跳过 - Node.js：
if (ws.readyState === WebSocket.OPEN)
状态码不是可选参数，1000 和 4001 的语义差异直接影响客户端行为
关闭帧里的状态码不是装饰，客户端会据此决定是否重连、如何提示用户、要不要清空本地缓存。硬编码 1000 或留空（默认也是 1000）看似省事，但掩盖了业务意图。
比如服务端因维护要批量下线连接，用 1001（端点离开）能让前端统一展示“服务暂不可用”，而不用 1000 让用户误以为是自己网络问题。
- 必须避免用
0、1004、1005等保留/未定义码，浏览器或库可能拒绝解析 - 自定义码应 ≥
4000，且需双方约定含义；例如4001表示“账号在别处登录”，4002表示“权限变更需刷新” - reason 字符串长度限制 123 字节（RFC 6455），超长会被截断，关键信息别放这里
close()，而是关之前有没有确认连接还活着、关之后有没有等对方点头、关完有没有把关联的定时器/缓存/数据库事务一并收掉。这些步骤漏掉任意一环，都可能让“主动关闭”变成“连接泄漏”或“状态错乱”。 
