核心用法
本 skill 提供生产级 WebSocket 连接管理最佳实践，解决连接稳定性、可观测性与扩展性三大核心问题。
重连机制：采用指数退避算法（1s→2s→4s→8s→30s上限）叠加随机抖动，防止服务端恢复时的"惊群效应"。连接中断期间消息入队，恢复后重播，并设置最大重试次数避免无限静默重试。
心跳保活：应用层每 30s 发送心跳，10s 内未收到响应即判定连接死亡。双端心跳设计可及时发现僵尸连接，清理服务端资源；频率需高于代理空闲超时（通常 60-120s），不可依赖 TCP keepalive。
状态管理：严格遵循 readyState 状态机，CONNECTING 阶段缓冲消息，通过 bufferedAmount 感知背压。多 Tab 场景下利用 BroadcastChannel 或 SharedWorker 协调连接，避免资源浪费。
认证方案：权衡 URL 传参（简单但泄露日志）、首消息认证（安全但延迟高）、Cookie 同源认证（受限无自定义头）三种模式，重连后必须重新鉴权。
水平扩展：WebSocket 有状态特性决定需采用粘性会话（按 client ID 路由）或 Redis pub/sub 广播方案，配合优雅关闭实现零停机迁移。
显著优点
- 经过大规模生产验证的容错设计
- 完整的代理/Nginx 配置模板
- 标准化关闭码体系（1000-4999）便于问题定位
- 覆盖二进制/文本帧、消息分片、Origin 校验等边缘场景
潜在局限
- 方案偏重浏览器-服务端架构，原生移动端需适配
- 未提供具体语言实现，需自行编码
- 高并发场景下内存占用显著，需预留容量规划
适合人群
- 构建实时聊天、协同编辑、数据推送等系统的全栈开发者
- 需要保障 99.9% 消息到达率的 SaaS 架构师
- 从 HTTP 长轮询迁移至 WebSocket 的技术团队
常规风险
- 无心跳导致"幽灵连接"，消息丢失无感知
- 退避策略缺失引发服务端雪崩
- Origin 校验遗漏造成 CSWSH（跨站 WebSocket 劫持）
- 单连接消息洪泛未限速，拖垮 event loop
- 关键状态仅存于内存，重连后用户会话断层