Workerman移动端切换网络后怎么重连

阿浩姑娘_6976

阿浩姑娘_6976

2026-09-01

984人浏览

原创

移动端网络切换时WebSocket必然断开,需前端监听onclose并实施指数退避重连(1s→3–5s±1s抖动→15–30s),配合服务端心跳超时≤90秒、重连后认证绑定与离线消息补发。

workerman移动端切换网络后怎么重连

移动端切换网络时 WebSocket 连接必然断开

这是 TCP 层面的客观限制:4G 切 WiFi、飞行模式开关、后台冻结等操作都会导致底层 socket 被系统回收,onclose 事件一定会触发。Workerman 服务端对此无感知、也无法干预——重连必须由前端主动发起。

前端必须监听 onclose 并实现指数退避重连

固定间隔(如 3 秒)会引发雪崩式请求,尤其在弱网或模组冷启动场景下完全失效。真实设备网络恢复有延迟,比如 SIM 卡重注册可能耗时 8 秒,盲目重试只是空转。

  • 首次断开:立即尝试重建 new WebSocket()
  • 连续失败 2 次:延迟升至 3–5 秒,并加 ±1 秒随机抖动
  • 连续失败 5 次:延迟拉到 15–30 秒,同时检查 navigator.onLine 和信号强度(如 modem.getSignalLevel())
  • 4G 模组必须监听 AT 响应(如 +CGATT: 1、+CREG: 1,1),仅当注册成功后再建连接

服务端要配合做心跳超时控制,不能只靠客户端

运营商 NAT 防火墙普遍在 60–120 秒内静默回收空闲连接,Linux 的 tcp_keepalive_time 在此场景下完全无效。服务端若不主动探测,会误判“连接还活着”,导致消息堆积或状态错乱。

iTerms
iTerms

一款AI工具,主要用于法大大AI法律顾问,适合需要提升相关任务效率的用户。

下载
  • onMessage 第一行必须无条件更新 $connection->lastMessageTime = time(),不管消息是否是 JSON、能否解析
  • 心跳建议用二进制前缀(如 \x01)或子协议区分,避免依赖 JSON 结构导致解析失败就跳过时间戳更新
  • 服务端超时阈值必须 ≤90 秒(容忍一次心跳丢失),低功耗设备可放宽至 150 秒
  • 未绑定 UID 的匿名连接也要初始化 lastMessageTime,否则定时器遍历时会触发 PHP Notice

重连后需重新绑定用户身份和业务上下文

单纯重建 WebSocket 连接不等于业务恢复。用户可能已切换账号、订单状态已变更、或上次连接携带的 JWT 已过期。

  • 重连成功后,前端应立刻发送带签名的认证包(如 {"type":"auth","token":"..."})
  • 服务端收到后调用 $connection->bindUid(),并校验 token 有效性与权限范围
  • 若旧连接仍残留未处理完的消息(如离线推送),需通过 Redis 或消息队列补发,不能假设“重连即同步”
  • 避免在 onClose 或 onMessage 中做重连逻辑——这些回调不在 Worker 初始化上下文中,无法安全重建资源

真正的难点不在写几行 setTimeout,而在于让前端重连策略理解模组真实的网络生命周期,并和服务端心跳、认证、上下文恢复形成闭环。任何一环脱节,都会表现为“看起来连上了,但消息收不到”。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

workerman

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

226

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

222

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

247

13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

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

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

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习