Vue项目怎么使用WebSocket Vue3封装WebSocket插件教程【干货】

夏瑶同学_1965

夏瑶同学_1965

2026-06-04

527人浏览

原创

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

vue项目怎么使用websocket vue3封装websocket插件教程【干货】

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 Builder
Springboot Vue Builder

从零开始编排 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实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3969

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2548

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1480

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1418

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1476

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2498

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

4220

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

20375

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

569

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.6万人学习

Vue3.x 核心篇--十天技能课堂
Vue3.x 核心篇--十天技能课堂

共30课时 | 2.5万人学习

Vue3.x新特性篇--十天基础课堂
Vue3.x新特性篇--十天基础课堂

共20课时 | 1.8万人学习