如何利用“单例模式”配合闭包确保在单页应用中全局仅存在一个 WebSocket 长连接实例
为什么不能直接 new WebSocket() 多次调用
在单页应用（SPA）开发中，如果每个页面或组件都随意调用 new WebSocket(url)，会导致多个独立的物理连接同时建立。这不仅会造成服务端资源浪费，将同一个客户端识别为多个独立会话，还可能引发消息重复接收、状态管理混乱等问题。更关键的是，重连逻辑会分散在各个组件中，难以统一控制。在 uni-app、Taro 等跨端框架中，问题更为突出——new WebSocket() 这一原生 API 仅在 H5 环境有效，在小程序或 App 端并不可用。直接使用将导致代码无法跨平台运行，破坏项目的一致性。
闭包单例如何避免多次初始化
核心解决方案是利用立即执行函数表达式（IIFE）结合闭包，将连接实例变量封装在私有作用域内，确保全局唯一。外部只能通过暴露的 getInstance() 方法获取实例，首次调用时创建连接，后续调用均返回同一实例：
const WebSocketSingleton = (function () {
let instance = null
return {
getInstance: function (url) {
if (!instance) {
// 这里必须用平台兼容的 API，比如 uni-app 用 uni.connectSocket
instance = {
url,
socket: null,
connect() {
uni.connectSocket({ url })
uni.onSocketOpen(() => { /* 存引用 */ })
uni.onSocketMessage((e) => { /* 转发给监听者 */ })
},
send(data) { uni.sendSocketMessage({ data }) }
}
}
return instance
}
}
})()
- 当再次调用
WebSocketSingleton.getInstance('wss://...')时，由于闭包内instance已存在，会直接返回现有实例，避免重复创建连接。 - 这里需注意一个潜在风险：即使传入不同的
url参数，闭包逻辑仍可能返回首次创建的实例。这虽保证了唯一性，但也意味着后续传入的新 URL 会被忽略。因此，务必确保所有调用处传入的 WebSocket 地址完全一致。 - 若项目需要连接多个不同的 WebSocket 服务端点（例如区分消息服务和通知服务），建议将 URL 配置集中管理，或扩展单例模式以支持多实例键值对存储，而非在
getInstance中动态传入。
uni-app 下必须用 uni.connectSocket，不是可选项
在 uni-app 项目中，必须使用官方提供的 uni.connectSocket API 来建立跨端一致的 WebSocket 连接。该 API 在不同平台底层实现不同，使用时需遵循以下规范：
- 调用时机：应在页面的
onReady生命周期之后调用。在onLoad阶段调用可能导致在 App 端连接失败。 - URL 协议：必须使用安全的
wss://协议。小程序平台会强制校验，仅 H5 环境在本地调试时可临时使用ws://。 - 参数编码：查询参数需使用
encodeURIComponent进行编码。例如?token=abc+def若不编码，可能在传输过程中被截断或解析错误，导致连接异常断开。 - 发送时机：必须在
uni.onSocketOpen连接成功事件触发后才能调用uni.sendSocketMessage发送消息，否则会抛出“websocket not connected”错误。
断开重连和状态清理最容易被忽略
实现单例模式只是第一步，连接的生命周期管理同样关键。在实际应用中，网络波动、应用切换至后台、小程序被系统回收等场景都会触发连接断开。若仅依赖单例而不处理重连与清理，instance.socket 可能仍持有无效引用，导致消息发送静默失败。
- 状态重置：在
uni.onSocketClose或uni.onSocketError事件回调中，必须手动将instance.socket置为 null，并清理相关监听器，为重新连接做好准备。 - 智能重连：重连机制不建议使用固定时间间隔的
setTimeout。应采用指数退避策略，例如首次重连等待 1 秒，第二次 3 秒，第三次 9 秒……通常设置最大重试次数（如 5 次），避免无限重连消耗资源。 - 生命周期同步：在 App 或小程序的
onHide生命周期中，应主动调用uni.closeSocket()并重置单例状态。当用户返回应用时，再按需重新建立连接，避免持有“僵尸连接”。
总而言之，闭包单例模式确保了 WebSocket 实例在全局范围内的唯一性，但连接的稳定性、错误恢复能力以及与应用生命周期的协同，仍需开发者通过完善的重连、清理和状态同步机制来保障。忽略这些细节，单例模式将只是一个易于维护却缺乏健壮性的架构外壳。
