SharedWorker 实现全局长连接，降低服务端压力

SharedWorker 是浏览器中唯一真正支持跨标签页复用 WebSocket 连接的原生机制，能显著降低服务端并发连接压力，但其实现远非简单封装——必须将连接创建、重连策略、心跳保活、消息路由（含 clientId 隔离）、状态同步等全部逻辑下沉至 Worker 内部，并严格遵循同源 HTTPS/localhost 安全限制；任何试图在主线程操作 WebSocket 或依赖外部协调的方案都会导致多连接、状态错乱或静默失败，而高并发场景下还需警惕端口数限制并设计优雅降级策略。

SharedWorker 是目前浏览器端唯一能真正复用 WebSocket 实例、从而降低服务端并发连接数的机制。它不是“理论上可行”，而是唯一被浏览器内核支持的跨标签页共享连接方案——其他方式（BroadcastChannel + 主页面代理、localStorage 轮询、Service Worker 中转）都绕不开多连接或状态错乱问题。

SharedWorker 必须在同源 HTTPS 或 localhost 下运行

浏览器会静默拒绝非安全上下文中的 new SharedWorker() 调用，连 onerror 都不会触发。开发阶段必须确认：

• 本地调试用 http://localhost:port，不能用 file:// 协议
• 上线后必须是 https://，HTTP 域名即使同源也会直接失败
• Safari 仅支持 macOS 13.3+ / iOS 16.4+，旧版本需 fallback 到单页独连

WebSocket 实例必须且只能在 SharedWorker 内创建

常见错误是试图在页面中 new WebSocket() 后通过 postMessage 传给 Worker——这会抛出 DOMException: Failed to execute 'postMessage' on 'MessagePort'，因为 WebSocket 对象不可序列化。

• 所有连接逻辑（new WebSocket(url)、onopen、onmessage、onclose）必须写在 shared-worker.js 中
• Worker 收到页面发来的 { type: "connect", url: "wss://..." } 后，需先检查 ws?.readyState === WebSocket.CLOSED 才新建实例，避免重复 new
• 页面不能持有或操作 WebSocket 实例，只负责发送指令和接收转发消息

消息路由必须显式携带 clientId 并隔离分发

单链路不等于单业务流。多个窗口共用一条连接后，A 窗口订阅的 topic、收到的私有消息，绝不能推送给 B 窗口——这不是 Worker 自动做的，而是靠协议层标识控制。

• 页面首次接入时发 { type: "init", clientId: self.crypto.randomUUID() }
• Worker 用 Map 存储映射关系，并在校验 port.onmessage 时强制要求字段存在
• 服务端返回的消息必须含 targetClientId 或 topic，Worker 查表后只调用对应 port.postMessage()
• 页面关闭前主动发 { type: "disconnect", clientId: "..." }，Worker 清理映射与缓存的订阅快照

重连、心跳、状态同步必须全部下沉到 SharedWorker 内部

如果把重连逻辑放在页面里，多个标签页会同时触发重连请求，造成服务端雪崩；如果依赖主线程定时器，页面切后台后心跳会失效。

• 使用 setInterval 发送 "ping"，服务端需响应 "pong"；连续两次无响应即 ws.close() 并触发重连
• 断连后执行指数退避：1s → 2s → 4s → … 最大 30s，避免连接风暴
• 重连成功后，自动重发各窗口缓存的 subscribe 请求（需在 Worker 内维护订阅快照）
• 通过 port.postMessage({ type: "status", state: "connecting" }) 向所有页面同步状态，UI 可据此更新指示器

最易被忽略的一点：SharedWorker 的端口数有硬性限制（Chrome 约 100–200 个），超过后新标签页调用 new SharedWorker() 会静默失败。千级标签页场景下，必须降级为 BroadcastChannel 分片 + localStorage 同步，而非强行堆叠 SharedWorker 实例。

今天关于《SharedWorker 实现全局长连接，降低服务端压力》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！