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

uni-app怎么实现长连接心跳检测

冬晨酱_5767

冬晨酱_5767

发布时间:2026-09-17 06:01:17

|

640人浏览过

|

来源于php中文网

原创

WebSocket心跳必须主动发ping并校验pong响应,因onClose在微信小程序切后台或H5休眠时不可靠;需统一响应格式、用setTimeout链式调用、设置超时重连及平台保活策略。

uni-app怎么实现长连接心跳检测

uni-app 里 WebSocket 心跳检测不能只靠 onClose,必须主动发 ping 并等待 pong 响应,否则微信小程序会静默断连、H5 页面休眠后不触发回调。

为什么 onClose 不可靠

微信小程序在切后台或页面不可见时,onClose 根本不会触发,连接直接被系统静默回收;H5 端虽能触发,但若浏览器标签页休眠,onClose 可能延迟数秒甚至完全丢失。这意味着你无法依赖它来判断“是否还连着”。

  • 所有平台都必须自己发心跳,不能等断连才处理
  • 心跳不是发完就完,关键要确认服务端真的收到了、并返回了可识别的响应
  • 微信小程序需额外监听 onHide/onShow,在 onHide 中手动 close 连接,避免残留无效实例

uni.sendSocketMessage 发心跳的正确姿势

很多开发者直接用 send 发字符串 "ping",但服务端可能没按约定返回 "pong",或者前端没做 JSON 解析就比对 data.type,结果永远收不到匹配。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 统一约定服务端心跳响应为纯文本 "pong"(最简单)或固定结构 {"op":"pong"},避免嵌套字段干扰
  • 前端收到 onMessage 后,先 JSON.parse(res.data) 再取 op 或直接比对字符串,别漏这步
  • 不要用 setInterval 发心跳:重连时旧定时器未清除,会导致多个心跳并发发送
  • 改用 setTimeout 链式调用,每次发完立刻设下一次,确保只有一个定时器活跃

心跳超时与重连怎么配合

心跳间隔和超时时间必须和服务端协商好,光客户端设 30s 发一次 ping,服务端却只等 25s 就断,照样掉线。

  • 推荐客户端心跳间隔设为 30000(30 秒),服务端 ping_timeout 设为 45000(45 秒),留出网络抖动余量
  • 发完 ping 后,立即启动一个 5000 毫秒的 setTimeout 等 pong;超时未收到就 socketTask.close() 并触发重连
  • 重连前先调用 uni.getNetworkType,返回 none 时不尝试,避免无效请求
  • 重连次数限制为 5 次,第 6 次起用指数退避(1s → 2s → 4s → 8s),防止打爆服务端

App 端后台心跳保活的特殊处理

iOS 和 Android 在真后台下,JS 定时器和网络请求大概率被系统终止,前端逻辑做的心跳基本无效。

  • iOS 必须在 manifest.json 的 ios 节点配 "usesBackgroundModes": ["audio"],否则进后台 30 秒内必断
  • Android 需引导用户关闭厂商省电优化(华为/小米/OPPO),否则进程被强杀
  • 低电量时调用 uni.getBatteryInfo 判断,把心跳从 30s 降频到 2min 一次
  • 真后台场景下,别指望 JS 定时器——改用 plus.push.addEventListener('click', ...) 或云函数查“最后活跃时间”兜底

真正难的不是写几行 send 和 setTimeout,而是把心跳响应校验、平台差异处理、后台保活策略、重连节流这些点串成一条闭环逻辑。漏掉任意一环,长连接在某个平台或某种场景下就会悄无声息地失效。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

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

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2183

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4663

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5790

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5238

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

743

2024.05.22

promise的用法
promise的用法

“promise” 是一种用于处理异步操作的编程概念,它可以用来表示一个异步操作的最终结果。Promise 对象有三种状态:pending(进行中)、fulfilled(已成功)和 rejected(已失败)。Promise的用法主要包括构造函数、实例方法(then、catch、finally)和状态转换。

4100

2023.10.12

html文本框类型介绍
html文本框类型介绍

html文本框类型有单行文本框、密码文本框、数字文本框、日期文本框、时间文本框、文件上传文本框、多行文本框等等。详细介绍:1、单行文本框是最常见的文本框类型,用于接受单行文本输入,用户可以在文本框中输入任意文本,例如用户名、密码、电子邮件地址等;2、密码文本框用于接受密码输入,用户在输入密码时,文本框中的内容会被隐藏,以保护用户的隐私;3、数字文本框等等。

3323

2023.10.12

Golang WebSocket与实时通信开发
Golang WebSocket与实时通信开发

本专题系统讲解 Golang 在 WebSocket 开发中的应用,涵盖 WebSocket 协议、连接管理、消息推送、心跳机制、群聊功能与广播系统的实现。通过构建实际的聊天应用或实时数据推送系统,帮助开发者掌握 如何使用 Golang 构建高效、可靠的实时通信系统,提高并发处理与系统的可扩展性。

175

2025.12.22

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

0

2026.09.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

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

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