前端WebSocket重连规范书.docVIP

前端WebSocket重连规范书

一、重连触发机制设计

（一）连接状态异常触发

WebSocket连接的生命周期中，多个状态变化可直接触发重连逻辑。当readyState属性变为CLOSED（值为3）时，需立即启动重连流程，但需排除主动调用close()方法导致的关闭场景。可通过监听onclose事件并检查code参数判断：若code为1000（正常关闭）或1001（端点离开）且为主动触发，则不执行重连；若code为1006（异常关闭）、1011（服务器内部错误）等被动关闭码，或wasClean属性为false，则直接触发重连。

同时，onerror事件的触发也需作为重连信号。当连接过程中发生网络错误、证书验证失败或协议不兼容等问题时，onerror事件会被触发，此时无论当前连接状态如何，都应立即终止现有连接并启动重连。需注意在onerror事件处理函数中避免重复触发重连，可通过设置状态锁（如isReconnecting变量）防止并发重连请求。

（二）心跳超时触发

在长连接场景中，心跳机制是检测连接活性的核心手段。客户端需定时向服务器发送心跳包（如{type:ping}），并启动超时计时器。若在指定时间（如30秒）内未收到服务器返回的心跳响应（pong包），则判定连接已失效，触发重连逻辑。

心跳超时的判定需考虑网络延迟波动，可采用动态超时策略：首次超时时间设为30秒，若连续两次超