讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

为什么长连接必须要设计心跳机制?Workerman心跳配置实战

阿晨吖_6137

阿晨吖_6137

发布时间:2026-05-25 22:00:22

|

690人浏览过

|

来源于php中文网

原创

长连接断开主因是中间件超时主动断连而非网络故障;需在Workerman中自实现心跳机制,同步响应ping/pong,并配合Nginx调大proxy_read_timeout等参数。

为什么长连接必须要设计心跳机制?workerman心跳配置实战

长连接断开不是因为“网络坏了”,而是中间件主动砍的

长连接本身在 TCP 层面是稳定的,只要两端进程没挂、物理链路没断,连接就能一直维持。但现实里你根本等不到“自然存活”,因为从客户端到服务端之间堆着一堆中间件:Nginx 默认 proxy_read_timeout 60s、运营商 NAT 网关空闲超时常为 30–120 秒、AWS ALB 固定 60 秒不可调、Android 系统后台休眠后 Socket 可能被静默回收。它们不关心你逻辑上“还没说完”,只认“这管道多久没流水了”。一旦超时,直接 FIN 断连,且不通知你。

Workerman 中 onMessage 不等于心跳,得自己加探测逻辑

Workerman 的 onMessage 只响应真实业务消息,它不会自动触发任何保活行为。如果你只靠用户发聊天消息来“刷活”,那两次消息间隔一超过中间件超时阈值,连接就凉了。必须显式插入心跳探测流程:

  • 客户端需定时(比如 25 秒)发送一个轻量协议包,例如 JSON:{"type":"ping","ts":1716498543}
  • 服务端在 onMessage 里识别该 type,不做业务处理,仅立即回 {"type":"pong"}
  • 同时维护每个 $connection 的最后心跳时间戳,用 Timer::add() 启动后台检查任务,比如每 30 秒扫一次,对超时(如 >60 秒未 ping)的连接调用 $connection->close()

注意:别把心跳响应写成异步回调或丢进协程队列——它必须同步、低延迟、无阻塞,否则 pong 拖延会导致客户端误判超时。

Worker::$maxConnection 和心跳并发数不是一回事

Workerman 的 $maxConnection 控制的是最大允许建立的连接数,但它不感知连接是否“真活着”。如果你没做心跳清理,大量假连接会占满这个配额,新用户连不进来,而监控看连接数又没爆,排查起来极隐蔽。

  • 心跳超时清理必须独立实现,不能依赖 Workerman 自带连接管理
  • 检查频率建议设为心跳间隔的 1.5–2 倍(如心跳 25s,检查周期设 40s),避免高频扫描损耗 CPU
  • 清理动作要加锁或用 if ($connection->isConnected()) 再 close,防止 race condition 导致对已断连接重复 close 报 warning

Nginx 配置不改,Workerman 心跳再勤也白搭

Workerman 侧的心跳只是应用层努力,若 Nginx 还卡着默认 60 秒,它会在第 61 秒直接断掉 TCP 连接,客户端收不到任何 pong,只会看到 WebSocket is already in CLOSING or CLOSED state 或直接 onerror。必须同步调整 Nginx:

  • proxy_read_timeout 86400; —— 允许后端 24 小时不发数据也不断
  • proxy_send_timeout 86400; —— 同理,防止大包分片慢导致误杀
  • proxy_set_header Connection 'upgrade'; 和 Upgrade $http_upgrade; 必须存在,否则 Nginx 当普通 HTTP 处理,压根不通 WebSocket

配置生效后记得 nginx -t && nginx -s reload,光改配置不重载等于没改。

最容易被忽略的一点:心跳包内容不能全一样。有些防火墙或代理会缓存“重复小包”并直接丢弃,建议在 ping 中带上毫秒级时间戳或递增序号,确保每次都是新 payload。

热门AI工具

更多
豆包大模型

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

讯飞绘文

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

DeepSeek

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

WorkBuddy

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

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

相关专题

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

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

226

2026.05.20

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

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

222

2026.05.20

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

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

247

2026.05.20

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

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

140

2026.11.12

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

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

100

2026.11.12

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

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

60

2026.11.12

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

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

160

2026.11.06

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

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

140

2026.11.06

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

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

120

2026.11.06

热门下载

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

精品课程

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

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

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

共0课时 | 0人学习

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

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