Workerman TCP心跳怎么实现

浅萱姑娘_3635

浅萱姑娘_3635

2026-09-07

475人浏览

原创

Workerman的TCP心跳需应用层自行实现,heartbeat_idle_time仅被动检测有通信历史的连接空闲时长,无法覆盖静默连接;标准方案是客户端定时发ping、服务端onMessage回pong并手动更新lastPingTime,同时配合定时扫描踢出假死连接。

workerman tcp心跳怎么实现

Workerman 的 TCP 心跳必须由应用层自己实现,Workerman 本身不提供自动心跳机制。 它只负责连接的收发和维持,超时断开靠 connection_timeout 和 heartbeat_idle_time 配合手动心跳逻辑完成。

为什么不能只靠 heartbeat_idle_time

很多人以为设了 heartbeat_idle_time = 60 就能自动保活,其实它只起“被动检测”作用:只有当客户端发过数据、服务端收到后才开始计时;如果客户端从不发任何包(比如纯监听型设备),这个计时器压根不会启动,连接会一直挂着直到被系统 kill 或防火墙中断。

  • heartbeat_idle_time 不是心跳发送间隔,而是“最后一次收/发数据后允许空闲的最大秒数”
  • 它只在连接有通信历史的前提下生效,静默连接不受控
  • 仅靠它无法解决 NAT 超时、中间设备丢连接等问题

标准做法:客户端定时发 ping,服务端用 onMessage 回 pong

这是最通用、兼容性最好的方式。客户端每 30 秒发一次 ping(可自定义字符串或二进制标记),服务端收到后立即回一个 pong 并刷新连接活跃时间。

万兴喵影
万兴喵影

万兴喵影是一款由万兴科技推出的 AI 全能视频剪辑和创作软件。

下载
use Workerman\Worker;
$worker = new Worker('tcp://0.0.0.0:1234');
$worker->onMessage = function($connection, $data) {
    // 简单判断是否为心跳包(按实际协议约定)
    if ($data === "ping\n" || $data === "\x01") {
        $connection->send("pong\n");
        // 强制刷新心跳计时器(关键!)
        $connection->lastPingTime = time();
        return;
    }
    // 处理业务数据...
};
  • 务必在收到 ping 后手动更新 $connection->lastPingTime,否则 heartbeat_idle_time 不会重置
  • 客户端要处理 pong 超时(比如发完 ping 5 秒没回就主动断连重连)
  • 避免用 JSON 或复杂解析做心跳判断,增加 CPU 开销且易出错

服务端也要主动踢掉假死连接

光等客户端发 ping 不够保险。得配合 onClose + 定时扫描,清理长时间没发任何数据的连接。

$worker->onWorkerStart = function($worker) {
    // 每 10 秒扫一次
    \Workerman\Lib\Timer::add(10, function() use ($worker) {
        foreach ($worker->connections as $connection) {
            if (time() - $connection->lastPingTime > 90) {
                $connection->close();
            }
        }
    });
};
  • lastPingTime 需在 onConnect 初始化(如 $connection->lastPingTime = time();),否则首次判断可能为 null 导致误杀
  • 扫描间隔建议 ≤ heartbeat_idle_time 的 1/3,太长会导致假死连接滞留
  • 别在 onMessage 里直接调 $connection->close(),容易引发并发异常,用定时器异步处理更稳

真正难的不是写几行 ping/pong,而是把心跳和业务协议对齐、覆盖所有异常路径(比如客户端崩溃没发 FIN、网络闪断后重连未清旧连接)、以及让客户端和服务端的心跳超时策略互相咬合。漏掉任意一环,都可能在线上表现为“连接明明还在,消息却收不到”。

相关文章

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