指数退避需满足重试次数清零、最大延迟截断和随机抖动三要素，否则重连易失效；WebSocket重连须基于event.wasClean===false且非1000码触发，并配合双向心跳与正确状态管理。
直接说结论：指数退避不是“加个 settimeout 就完事”，关键在重试次数清零时机、最大延迟截断、以及是否叠加随机抖动——这三点漏掉任一，重连就容易在真实网络抖动中失效或打爆服务端。
WebSocket onclose 里触发重连为什么总失败？
常见错误是把 onclose 当作“连接断开”的唯一信号，但实际它会因 ws.close()、网络中断、服务端主动踢出、甚至浏览器标签页休眠而触发。其中 event.wasClean === false 才代表非预期断开，才该重连。
- 必须检查
event.wasClean，否则用户主动关闭后还会傻等重连 -
event.code是 1001（going away）或 1006（abnormal closure）时，大概率需重连；1000（normal closure）则跳过 - 不要在
onclose里直接调用connect()，要先清理旧实例、清除定时器、重置状态变量
指数退避的 delay 计算必须带截断和抖动
纯 baseDelay * Math.pow(2, retryCount) 在第 10 次重试时会到 512 秒，既浪费用户等待时间，也失去重连意义。生产环境必须加两层控制：
- 上限截断：
Math.min(delay, maxDelay)，maxDelay建议设为 30000（30 秒） - 随机抖动：
delay * (1 + Math.random() * randomFactor)，randomFactor推荐 0.3～0.5，避免集群客户端同步重连 - 重试次数不能全局累加，每次成功连接后必须重置
retryCount = 0，否则下次断开直接从高位延迟开始
心跳包不配合，指数退避就是纸老虎
只靠 onclose 事件检测断连太被动——TCP 连接可能“假死”（socket 仍 open，但数据发不出去），这时 onclose 根本不触发，重连逻辑永远等不到机会。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 必须实现双向心跳：客户端定时发
{ type: "ping", ts: Date.now() }，服务端收到后立刻回{ type: "pong" } - 客户端起一个
setTimeout监听 pong 响应，超时（如 5000ms）就手动调用ws.close(4999, "heartbeat timeout")，强制触发onclose - 心跳间隔建议 25～30 秒，超时阈值设为间隔 + 5 秒缓冲，避免误判
React/Vue 中重连状态管理最容易踩的坑
Hook 或 Composition API 里，retryCount 如果用 useState 或 ref 存在闭包陷阱：重连函数被创建时捕获的是旧值，导致 retryCount 永远卡在 0 或重复累加。
立即学习“前端免费学习笔记（深入）”；
- 用
useRef存储重试计数，并在重连函数内显式读写retryCountRef.current - 重连定时器必须用独立
ref（如reconnectTimerRef）存，每次重连前clearTimeout(reconnectTimerRef.current) - 组件卸载时（
useEffect cleanup或onBeforeUnmount）必须清除所有定时器、关闭 ws 实例、置空 ref，否则内存泄漏+后台重连白跑
真正难的不是写出指数退避公式，而是让每一次重连都发生在“网络已恢复但服务端还没被压垮”的那个时间窗口——这需要心跳兜底、抖动打散、状态隔离三者咬合。少一个，就只是看起来像重连，而不是真能重连上。
