WebSocket连接频繁断开主因是TP8.0服务端未实现心跳闭环，需客户端和服务端协同处理JSON格式ping/pong、对齐超时阈值、补全onMessage响应及per-connection心跳检测，并规避压缩截断、路由拦截与重连雪崩等问题。
WebSocket 连接频繁断开，大概率不是网络本身问题，而是心跳没对齐、重连策略失控或 onclose 事件被静默吞掉 —— 尤其在 TP8.0（ThinkPHP 8.0）环境下，服务端默认不处理应用层心跳，客户端若只依赖浏览器原生 WebSocket API，根本收不到 Ping/Pong 帧，必须自己实现完整闭环。
为什么 TP8.0 下心跳容易失效
TP8.0 的 think-swoole 或 websocket 扩展默认只做连接管理，不解析或响应自定义心跳消息。如果你发的是 "ping" 字符串，而服务端没监听 onMessage 并主动回 "pong"，那客户端的超时检测就会误判断线。
- 服务端未注册
onMessage回调处理心跳类型（如{type: "ping"}），导致消息被丢弃 - TP8.0 路由或中间件拦截了 WebSocket 消息（比如 JSON 解析失败后静默返回空，不抛异常也不回包）
- 心跳间隔设为 30s，但服务端配置了
ping_interval=55（如 Swoole Gateway），双方节奏错位，客户端先超时 - 客户端用
ws.send('ping')发原始字符串，服务端却期待 JSON 格式，json_decode失败后跳过响应
onclose 触发后重连失败的常见原因
TP8.0 环境下，onclose 事件触发时，如果服务端还没真正释放连接（比如还在执行 onClose 中的耗时逻辑），客户端立刻重连可能撞上 TIME_WAIT 或握手被拒绝。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
- 重连前没清空旧
ws实例，导致多个WebSocket对象共存，onmessage绑定重复 - 重连定时器没用
clearTimeout/clearInterval清理，旧定时器仍在发心跳，新连接又启动一套，造成雪崩 - 重连间隔固定写死
5000，没做指数退避（reconnectDelay = Math.min(30000, initialDelay * 2 ** attempt)），服务器扛不住并发建连 - TP8.0 后端未校验重连请求的 token 或 session，直接拒绝新连接，但客户端日志只显示
close code 1006，无具体原因
客户端心跳 + 重连代码关键点（TP8.0 兼容）
以下逻辑必须和 TP8.0 服务端约定一致：心跳消息用 JSON 格式、字段名统一、超时阈值对齐。
- 发送心跳用
ws.send(JSON.stringify({ type: "ping", ts: Date.now() }))，避免纯字符串解析歧义 - 收到消息后优先判断
data.type === "pong"，再走业务逻辑，否则return -
onclose中设this.isManualClose = true，防止自动重连干扰用户主动断开 - 重连前检查
document.hidden，页面不可见时暂停重连（避免后台标签页疯狂建连） - 每次重连带上唯一
reconnect_id参数（如wss://host/ws?rid=abc123），方便 TP8.0 日志追踪是第几次重连
TP8.0 服务端需补的三处逻辑
光靠客户端努力没用，TP8.0 必须显式支持心跳闭环，否则所有客户端逻辑都是徒劳。
- 在
onMessage方法里加判断：if ($data['type'] === 'ping') { $this->send(['type' => 'pong', 'ts' => $data['ts']]); return; } - 在
onOpen中启动 per-connection 心跳检测定时器（Swoole 使用$this->tick()），超时未收 ping 则$this->close() - 在
config/websocket.php里暴露可配参数：'heartbeat_interval' => 25, 'heartbeat_timeout' => 45，并确保与前端完全一致
最常被忽略的是：TP8.0 默认把 WebSocket 请求当作普通 HTTP 处理，如果没在 swoole.php 配置中关闭 http_compression 或设置 websocket_compression，压缩后的二进制心跳包可能被截断或解析失败 —— 这类问题不会报错，只会让心跳静默失效。
