Vue 3 中应使用 Composition API 封装 useWebSocket Hook,核心是状态响应式(ref)、断线自愈(reconnecting-websocket)、心跳兜底(超时检测+主动断连),并配合 onBeforeUnmount 清理资源、事件解耦防泄漏。

Vue 3 项目里直接挂 new WebSocket() 不是不行,但上线后大概率会遇到连接断了不重连、心跳没发导致被服务端踢、消息发出去了但组件卸载了还在报错这些问题。真正能进生产环境的封装,核心就三点:状态可响应、断线能自愈、心跳有兜底。
怎么用 Composition API 封装一个可复用的 useWebSocket Hook
别写插件,插件在 Vue 3 里已经过时了;用自定义 Hook 更轻、更可控、和 ref / watch 天然契合。
-
url必须作为参数传入,不能硬编码在 Hook 内部——不同环境(dev/staging/prod)的地址通常不同 - 连接状态要用
ref而不是普通变量,否则组件里无法响应式读取isConnected.value - 必须在
onBeforeUnmount里调用ws?.close(),否则组件销毁后onmessage还在触发,this指向已失效实例,控制台报Cannot read property 'push' of undefined - 发送消息前务必检查
ws?.readyState === WebSocket.OPEN,否则会抛InvalidStateError
示例关键片段:
import { ref, onBeforeUnmount } from 'vue'
<p>export function useWebSocket(url) {
const ws = ref(null)
const isConnected = ref(false)
const messages = ref([])</p><p>const connect = () => {
ws.value = new WebSocket(url)
ws.value.onopen = () => { isConnected.value = true }
ws.value.onmessage = (e) => { messages.value.push(JSON.parse(e.data)) }
ws.value.onclose = () => { isConnected.value = false }
}</p><p>onBeforeUnmount(() => {
ws.value?.close()
})</p><p>return { ws, isConnected, messages, connect }
}</p>
reconnecting-websocket 库比原生 WebSocket 好在哪
原生 WebSocket 的 onclose 触发后,不会自动重连——你得自己写定时器、计数、退避策略。而 reconnecting-websocket 把这些都封装好了,且不绑定 Socket.IO 协议,适配任意标准 WebSocket 服务端。
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
- 安装:
npm install reconnecting-websocket - 它默认重试 10 次,每次间隔从 1s 开始指数退避(1s → 2s → 4s…),避免雪崩式重连请求
- 构造时传入的
maxRetries和connectionTimeout是最常调的两个配置项 - 注意:它返回的实例不是原生
WebSocket类型,所以ws.readyState不可用,要用ws.readyState === ReconnectingWebSocket.CONNECTING等静态值判断
心跳检测为什么不能只靠 setInterval 发 ping
单纯定时发 ping 只完成了“发”的一半。真正健壮的心跳必须包含超时判定 + 主动断连逻辑:如果连续两次没收到 pong,说明链路已哑,应主动 close() 触发重连流程,而不是等系统 TCP 层超时(可能长达几分钟)。
- 服务端必须支持
pong响应,否则心跳无意义 - 前端要维护一个
lastPongTime时间戳,在每次收到pong时更新;再用setInterval每 5 秒检查一次:若Date.now() - lastPongTime > 10000,就ws.close() - 不要把心跳逻辑塞进
onmessage里统一处理——万一服务端把业务消息也伪装成pong,会导致误判
消息收发如何避免组件卸载后内存泄漏
最常见的泄漏场景:组件 A 挂载时建立了 WebSocket 连接并监听 onmessage,但用户快速切到组件 B,A 被卸载,onmessage 回调里的 this.messages.push() 却仍在执行,因为回调函数还被 WebSocket 实例强引用着。
- 解决方案是「事件解耦」:不用
ws.onmessage = handler,改用ws.addEventListener('message', handler),然后在onBeforeUnmount里显式removeEventListener - 更推荐的做法是把消息分发交给一个中央事件总线(如
mitt),Hook 内只做连接管理,组件通过mitt.on('msg')订阅,卸载时调mitt.off('msg'),彻底解除绑定 - 如果用了
ref存消息列表,记得在组件卸载前清空:messages.value = [],否则旧数据仍驻留在内存中
真正的难点不在连上,而在连得稳、断得明、发得准、收得净——这些细节不处理,上线后第一波网络抖动就能让你的日志平台爆满。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










