主动触发 websocket 标准关闭流程是离开页面前安全销毁长连接的核心，需监听 pagehide 和 beforeunload 双事件调用 close(1000) 发送语义化关闭帧，清理本地资源，并配合服务端超时兜底。
离开页面前安全销毁 WebSocket 长连接，核心是主动触发标准关闭流程，而非依赖浏览器自动断开。直接关闭标签页或刷新时若不干预，连接会静默中断，服务端无法识别意图，前端收不到 clean 关闭信号，后续重连逻辑容易误判为异常断线。
监听 pagehide + beforeunload 双事件保障关闭时机
pagehide 比 beforeunload 更可靠，尤其在移动端和后台标签页场景下：
- 先注册 pagehide 事件，在页面隐藏（含切后台、关标签）时尝试调用
socket.close(1000, "Page hidden") - 再注册 beforeunload 作为兜底，仅执行同步操作：检查 socket 状态，若仍为 OPEN 或 CONNECTING，则调用
close(1000, "Page unloaded") - 避免在两个回调里写异步代码（如 await、fetch），浏览器可能已暂停脚本执行
- 即使 socket 已处于 CLOSED 或 CLOSING 状态，重复调用 close 也不会报错，可放心调用
发送带语义的关闭帧并等待协议闭环
仅前端调用 close 不代表关闭完成，需确保服务端响应匹配的关闭帧：
- 必须传入合法状态码，推荐 1000（正常关闭）或 1001（端点离开），避免使用 1006（该码仅用于异常中断，不可主动发）
- 原因字符串控制在 123 字节内，防止截断；例如
"User navigated away" - 服务端收到后应立即回传相同状态码的 CLOSE 帧，才算完成 RFC 6455 四次挥手
- 若前端 onclose 中
event.wasClean === false或event.code === 1006，说明未走完握手，需按异常处理
关闭后清理本地资源与状态
连接终止后必须归零所有关联状态，防止内存泄漏或后续误操作：
- 清除心跳定时器（
clearInterval(heartbeatId)）、取消 pending 的 send() 调用 - 将
socket实例置为null，避免后续代码意外调用send()报InvalidStateError - 清空消息缓存队列（如有），释放待发数据引用
- 在 onclose 回调中记录日志，包含
event.code、event.reason和event.wasClean，便于监控分析
服务端配合与超时兜底
不能完全依赖前端发关闭帧，服务端需设置合理容错机制：
- 配置连接空闲超时（如 30 秒无心跳即清理），不等待客户端主动关闭
- 心跳检测逻辑独立于 ping/pong 帧，统一走业务消息通道（如
{"type":"heartbeat"}） - 对未响应关闭帧的连接，超时后强制释放资源，避免堆积
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
