唯一复用单条tcp连接的方案是sharedworker托管websocket并用broadcastchannel同步状态:sharedworker内建连、页面发指令、broadcastchannel广播生命周期事件、worker路由消息到对应clientid页面,safari需降级为localstorage竞拍模式。

不能靠页面自己建 WebSocket,必须让 SharedWorker 承担连接职责,再用 BroadcastChannel 同步状态——这是目前唯一能真正复用单条 TCP 连接的方案。
SharedWorker 必须托管 WebSocket 实例
SharedWorker 脚本里可以直接调用 new WebSocket(),而普通页面或普通 Worker 都做不到。页面之间无法传递 WebSocket 对象(它不可序列化),postMessage() 会直接报错。所有连接逻辑必须收束在 Worker 内部。
- 页面只发指令,例如:
{ type: "connect", url: "wss://api.example.com/ws" } - SharedWorker 收到后才初始化连接,并缓存
ws实例供后续复用 - 关闭时必须显式调用
ws.close()并清空缓存,否则残留连接可能持续发送消息 - 所有
onopen/onmessage/onclose/onerror回调内都要加try...catch,防止未捕获异常导致 Worker 崩溃
BroadcastChannel 只负责广播连接生命周期事件
它不管理连接,也不转发业务数据,只做轻量、及时的状态通知。频道名必须完全一致,比如 "app-ws-bus",所有页面和 SharedWorker 都得用这个字符串初始化 BroadcastChannel 实例,否则消息对不上。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。
- SharedWorker 连接成功后,广播
{ type: "connected", id: crypto.randomUUID() } - 页面监听到该消息,就不再尝试建连,转而向 SharedWorker 注册自己的
port - SharedWorker 主动断连或异常关闭时,必须广播
{ type: "ws-closed" },否则其他页面可能继续往失效连接发请求 - 主控页需定期刷新本地状态(例如每 20 秒写入
localStorage或再次广播),防页面假死导致状态失联
每个页面必须带唯一 clientId 实现精准路由
一条连接被多个页面共享,但服务端下发的消息不能混发。SharedWorker 必须承担路由中枢职责:收到服务端消息后,按 clientId 解析并仅推送给对应 port,不广播。
- 页面首次通信时生成
clientId:优先用crypto.randomUUID(),降级用Date.now().toString() + Math.random() - SharedWorker 将
port与clientId映射存储,避免用localStorage时间戳这类弱标识(多页同时启动易冲突) - 服务端下发消息必须携带
targetClientId或topic字段,Worker 才能做条件分发 - 页面收到消息后,必须校验 payload 中的
clientId是否与本页一致,再执行 DOM 更新
Safari 兼容性兜底不是可选项
SharedWorker 在 Safari 中直到 iOS 16.4 / macOS 13.3 才支持,大量用户仍处于不支持状态。降级路径必须提前设计、默认启用检测逻辑,不能等运行时报错才 fallback。
- 启动时先判断
typeof SharedWorker === "function",不通过则立即走 BroadcastChannel + localStorage 竞选模式 - 竞拍逻辑要防并发:各页面尝试写入
localStorage.setItem("ws_owner", Date.now().toString()),以最新时间戳者为真主 - 主控页需每 20 秒刷新一次
ws_owner值,从属页监听storage事件,超时(如 >30 秒)即重新竞拍 - 降级模式下,BroadcastChannel 仍用于同步连接状态,但 WebSocket 由当选主控页创建并维护,其余页面只监听不建连
最容易被忽略的是:SharedWorker 的 onconnect 回调里必须第一时间创建 BroadcastChannel 实例,否则监听时机晚于广播,会导致部分页面收不到初始连接信号;另外,所有页面关闭前都应主动发送 { type: "disconnect", clientId } 给 SharedWorker,否则映射表持续膨胀,最终引发内存泄漏。










