讲师中心 微信公众号
AI工具推荐 视频效率加速

WebSocket心跳检测怎么写 自动断线重连代码分享【实战】

夜静同学_3347

夜静同学_3347

发布时间:2026-05-31 16:43:25

|

747人浏览过

|

来源于php中文网

原创

WebSocket连接后需主动发心跳,否则中间设备超时断连但readyState仍为1;重连逻辑须放onclose中并清理旧监听器,结合visibilitychange和健康检查避免重复消息与内存泄漏。

websocket心跳检测怎么写 自动断线重连代码分享【实战】

WebSocket连接后不发心跳,readyState 会卡在 1 却收不到消息

WebSocket本身不内置心跳机制,服务端通常靠客户端定时发 ping 或业务消息来判断连接存活。如果前端不主动发心跳,Nginx、CDN、云厂商LB(如阿里云SLB)或服务端的空闲超时(常见 60–300 秒)会直接切断 TCP 连接,但浏览器里 ws.readyState 仍显示 1(OPEN),后续 send() 会静默失败。

解决办法是:连接打开后立刻启动定时器,用 ws.send() 发一个轻量消息(比如 "ping"),或调用 ws.ping()(注意:该方法**未被所有浏览器支持**,Chrome 120+ 支持,Firefox 和 Safari 当前不支持,不能依赖)。

  • 推荐用业务层心跳:发送 JSON 字符串 {"type":"heartbeat"},服务端返回 {"type":"pong"}
  • 不要用 setTimeout 嵌套模拟间隔——用 setInterval 更稳,且要在 onclose 里 clearInterval
  • 心跳间隔建议设为服务端超时时间的 1/2~2/3,比如服务端超时 120 秒,前端心跳设 45 秒

onerror 和 onclose 都触发了,但重连逻辑没跑起来

很多人把重连写在 onerror 里,结果发现断网时只触发 onclose,而 onerror 只在连接建立阶段失败(如 DNS 解析失败、跨域拒绝)才触发。真正连接已建好后的异常断开,基本只走 onclose。

另外,onclose 触发时,ws 实例已销毁,不能再调 ws.close() 或 ws.send(),否则报 InvalidStateError: Failed to execute 'send' on 'WebSocket': Still in CONNECTING state。

WebSocket 8.18.2
WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。

下载
  • 重连逻辑必须只放在 onclose 回调里,且要判断 event.code:非 1000(正常关闭)或 1001(离开页面)才考虑重连
  • 加个重连次数限制和退避策略,比如第 1 次等 1s,第 2 次等 2s,第 3 次起固定 5s,避免雪崩式重连
  • 用闭包变量(如 let reconnectTimes = 0)记录当前重连次数,别存在 ws 实例上——它马上就被 GC 了

重连时反复创建 WebSocket 实例,内存泄漏还触发多次 onmessage

没清理旧监听器就新建连接,会导致多个 ws 实例同时监听 onmessage,旧连接哪怕已断开,只要没手动移除事件,回调仍可能执行(尤其在弱网下延迟触发)。更糟的是,每个 ws 实例都持有对 this 或外部作用域的引用,长期不释放会造成内存堆积。

核心原则:每次新连接前,确保旧连接已 close() 并解绑所有事件。

  • 封装一个 disconnect() 方法:调用 ws.close() + ws.onmessage = null + ws.onerror = null + ws.onclose = null
  • 不要用 addEventListener 绑定事件(那样得记 handler 引用才能 removeEventListener),统一用赋值式绑定
  • 重连前先执行 disconnect(),再 new WebSocket,避免“双 ws 并存”

移动端切后台再切回来,ws.readyState === 0 却还在重连

iOS Safari 和部分安卓 WebView 在页面切后台时会冻结 JS 定时器,setInterval 暂停,心跳停止;切回来瞬间,多个被积压的定时器回调可能集中触发,导致并发重连。更麻烦的是,切后台期间连接其实已被服务端或中间设备断掉,但前端 ws.readyState 还是 0(CONNECTING)或 1(没人通知它)。

应对方式不是等定时器恢复,而是借助页面可见性 API 主动干预:

  • 监听 document.visibilityState,visibilitychange 事件中:若变为 hidden,暂停心跳定时器(clearInterval);若变为 visible,先检查 ws.readyState !== 1 就立即重连,别等下一个心跳周期
  • 额外加个“连接健康检查”:每 10 秒用 setTimeout 检查一次 ws.readyState 是否为 1,不是就主动 close + 重连——这能覆盖定时器失准的场景
重连逻辑看着简单,实际要同时处理定时器生命周期、事件监听清理、页面状态变化、服务端协议配合这四层耦合。最容易漏的是切后台后的状态同步,以及没清掉旧 onmessage 导致消息重复处理——这两处一出问题,用户就会看到“一条消息弹两遍”或者“怎么连了十几次”。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

3729

2023.06.20

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

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

2468

2023.07.25

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

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

1420

2023.08.02

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

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

1358

2023.08.09

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

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

1436

2023.09.05

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

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

2398

2023.09.20

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

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

4000

2023.09.20

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

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

18995

2023.09.22

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebSocket手册
WebSocket手册

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn