组合式 API 封装 Socket.io 的核心是创建 useSocket 函数,实现单例连接管理、响应式状态跟踪(isConnected)、自动事件注册/清理、消息响应式绑定及可选重连策略,确保跨组件复用与生命周期同步。

用组合式 API 封装 Socket.io,核心是把连接管理、事件监听、发送逻辑和错误处理抽成可复用的响应式逻辑,避免每个组件重复写 socket.connect()、on()、off() 和手动清理。
封装连接与状态管理
创建一个 useSocket 组合函数,内部用 ref 管理 socket 实例和连接状态,配合 onMounted 和 onUnmounted 自动连接/断开。关键点是只在首次调用时初始化 socket,后续调用直接复用已存在的实例(单例模式),并用 isConnected 响应式暴露连接状态:
- 使用
let socket: Socket | null = null+const isConnected = ref(false)跟踪状态 - 连接时监听
connect和disconnect更新isConnected - 提供
connect()和disconnect()方法供手动控制 - 在
onUnmounted中自动调用disconnect(),防止内存泄漏
统一事件注册与自动清理
不直接暴露 socket.on(),而是封装 on(event, callback) 方法,内部用 Map 存储所有监听器,在组件卸载时批量 off()。这样避免忘记解绑导致重复触发:
- 维护
const listeners = new Mapvoid>>() -
on(event, cb)先检查 event 是否已存在,再 push 进数组,并调用socket.on(event, cb) -
onUnmounted中遍历 Map,对每个 event 执行socket.off(event) - 支持
once()封装,内部用socket.once()并自动清理
消息发送与响应式数据绑定
发送方法如 emit(event, data) 直接代理到 socket;接收数据则通过 const message = ref(null) 或 const messages = ref([]) 暴露响应式变量,让组件用 v-model 或 {{ message }} 直接消费:
- 例如
const userCount = ref(0),监听'user-count'事件后赋值:socket.on('user-count', n => userCount.value = n) - 对列表类数据,用
messages.value.push(newMsg)或messages.value = [...messages.value, newMsg]保持响应性 - 避免在回调中直接修改非响应式对象属性,始终走
.value赋值
错误处理与重连策略(可选增强)
在连接失败或断开时,提供可配置的重试逻辑。例如:监听 connect_error 后延迟 3 秒自动重连,最多尝试 5 次;同时暴露 error ref 供 UI 显示提示:
- 用
const error = ref记录最近错误信息(null) - 重连前清空旧监听器,避免重复绑定
- 提供
retry()方法供用户手动触发重连 - 实际项目中建议加退避机制(如指数退避),避免频繁请求压垮服务端
不复杂但容易忽略的是生命周期同步和事件清理——组合函数必须明确知道它属于哪个组件实例,否则跨组件共享 socket 时事件会混乱。只要把连接、监听、销毁三步收束在一个组合函数内,实时通信逻辑就能真正复用。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










