Workerman长连接为什么必须加心跳

陌婷大大_4874

陌婷大大_4874

2026-09-01

556人浏览

原创

不加心跳的Workerman长连接在真实网络中通常60秒内被中间件静默断开;需客户端每25秒发ping、服务端同步回pong,并调大Nginx proxy_read_timeout至86400,配合定时器扫描清理假连接。

workerman长连接为什么必须加心跳

不加心跳的 Workerman 长连接,在真实网络环境下基本活不过 60 秒——不是代码写错了,而是中间件直接把你“静默踢出”。

为什么 Nginx / ALB / 运营商网关会主动断连

TCP 连接本身可以空闲数小时不中断,但你根本等不到那一刻。现实链路中堆着一堆只认“空闲时间”的中间设备:

  • Nginx 默认 proxy_read_timeout 60s,第 61 秒无数据就发 FIN,不通知、不重试
  • AWS ALB 固定 60 秒超时,不可调
  • 国内三大运营商 NAT 网关普遍 30–90 秒空闲回收
  • Android 后台进程休眠后,系统可能直接回收 Socket 文件描述符

它们不关心你的业务逻辑是否“正在等待用户输入”,只看 recv() 是否持续有数据流。一旦超时,连接在 TCP 层已断,Workerman 的 $connection->isConnected() 在下一次读写前仍返回 true,造成“假存活”。

onMessage 不是心跳,别指望它自动保活

Workerman 的 onMessage 只响应真实业务消息,它不会因为你没发数据就帮你“刷线”。常见错误包括:

  • 把聊天场景当心跳:用户两分钟没打字,连接已被 Nginx 断开,onMessage 再也收不到任何东西
  • 误以为 Worker::$maxConnection 限制的是“活跃连接”:实际它只计数 accept() 成功的 socket,大量假连接占满配额,新用户连不上,监控却显示“连接数正常”
  • 在 onMessage 里处理心跳时用了协程或异步 Redis 查询:导致 pong 延迟 >25 秒,客户端判定超时并主动 close

正确做法是:客户端每 25 秒发一次 {"type":"ping","ts":1725225061};服务端在 onMessage 中识别 type === "ping",立刻同步回 {"type":"pong"},不走任何队列或 IO 等待。

心跳检测必须配定时器 + 连接状态双校验

光回 pong 不够,你还得主动清理“已断但未感知”的连接。Workerman 没有内置心跳清理,必须自己用 Timer::add() 实现:

AutoDraw
AutoDraw

一款结合机器学习识别能力的在线绘图工具,可以理解用户的简单草图并推荐对应的规范图形,降低绘图门槛。

下载
  • 检查周期建议设为心跳间隔的 1.5–2 倍(如客户端 25s 心跳,服务端每 40s 扫一次)
  • 每次扫描必须先调用 $connection->isConnected(),再判断 time() - $connection->last_message_time > 60,否则对已断连接重复 close() 会触发 PHP warning
  • 别给每个连接单独起一个 Timer::add():成千上万连接会撑爆最小堆。应统一用单个定时器遍历全局 $worker->connections

底层 Timer 基于最小堆,添加/执行复杂度是 O(log N),但高频创建定时器(比如每连接每秒一个)会导致堆频繁重排,CPU 升高且精度下降。

Nginx proxy_read_timeout 不改,心跳再勤也没用

Workerman 侧的心跳只是应用层努力,若前置代理卡着默认 60 秒,你客户端每 25 秒发 ping、服务端秒回 pong,到第 61 秒 Nginx 仍会单方面断开 TCP 连接。此时客户端收到的不是 pong,而是 WebSocket is already in CLOSING or CLOSED state 或直接触发 onerror。

必须同步修改 Nginx 配置:

location /ws {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_read_timeout 86400;  # 关键:设为 24 小时
}

这个值要大于你服务端心跳超时阈值(如 60 秒)和客户端最大可能延迟之和,否则所有心跳努力都在对抗一个根本没改的网关。

最易被忽略的一点:心跳包内容必须轻量、格式固定、解析零依赖。别用 json_decode($data, true) 全量解析再判断 type——万一客户端发了个非法 JSON,onMessage 就会因解析失败而跳过心跳逻辑,连接在下次扫描时被误杀。

相关文章

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人学习