WebSocket连接池是前端自研的连接管理机制，用于复用WebSocket实例、减少频繁建连开销，核心包括连接缓存、状态感知、心跳保活、空闲回收，并需安全清理避免内存泄漏与消息丢失。
WebSocket连接池不是HTML5标准的一部分，而是开发者在应用层为复用WebSocket连接、提升性能而设计的管理机制。浏览器原生只提供单个WebSocket实例（new WebSocket(url)），不支持自动复用或内置连接池。因此，“构建连接池”本质是前端代码对多个WebSocket对象的生命周期、状态、复用逻辑进行封装和调度。
为什么需要模拟连接池
频繁创建/关闭WebSocket连接会带来明显开销：TCP三次握手、TLS协商、服务端连接管理压力、客户端事件监听器反复绑定。尤其在微前端、多模块需实时通信的场景下，多个业务模块若各自新建连接，极易造成冗余连接、内存泄漏或服务端拒绝（如连接数超限）。连接池的目标是：按需复用、统一心跳、自动重连、空闲回收。
核心实现要点
一个轻量可用的前端WebSocket连接池应包含以下能力：
-
连接缓存与复用：以URL（或带身份标识的URL）为键，维护Map
{ url → { ws, status, lastUsed, pingTimer } }；请求连接时优先返回已建立且处于OPEN状态的实例 -
状态感知与自动恢复：监听
onopen/onerror/onclose，将异常连接标记为CLOSED或ERROR，触发后台重连（带退避策略），避免上层业务感知中断 -
心跳保活与空闲判定：对每个活跃连接启动定时
ping（如每30秒发一次自定义ping消息），收到服务端pong则刷新lastUsed时间戳；空闲阈值（如120秒）由Date.now() - lastUsed > idleTimeout判断 - 安全清理时机：空闲连接不能立即关闭——需确保无待发送消息、无未完成回调、无订阅者引用；建议在每次心跳检查后异步执行清理，并移除对应监听器和定时器
空闲连接清理的注意事项
盲目关闭空闲连接可能引发问题：
立即学习“前端免费学习笔记（深入）”；
- 服务端仍认为连接有效，后续发消息会丢失（WebSocket协议本身不主动通知对端“我将关闭”）
- 客户端清理后，新请求又重建连接，反而增加抖动
- 未清除
onmessage等监听器，导致内存泄漏（尤其使用闭包绑定上下文时）
推荐做法：清理前调用ws.close(1000, "idle cleanup")，并同步清空内部引用、清除pingTimer、从缓存Map中delete该条目；同时可暴露onConnectionEvicted钩子供业务侧做日志或统计。
不建议直接复用原生WebSocket实例
原生WebSocket对象不可重连：一旦进入CLOSED或ERROR状态，无法再次调用send()或重新触发onopen。所谓“复用”，仅指在连接存活期内供多个业务模块共用同一ws对象收发消息（需自行管理消息路由与回调分发），而非复用已断开的实例。真正断开后，必须新建实例。
