如何排查Workerman内存泄漏问题?内存持续升高怎么办?

聖光之護

聖光之護

2026-05-25

526人浏览

原创

workerman内存持续升高而memory_get_usage()无明显变化,主因是php引用计数未及时回收,存在循环引用、闭包捕获、静态变量等导致逻辑死亡对象未释放;需手动gc_collect_cycles()、用weakmap替代静态数组、清理onclose资源并借助xdebug_debug_zval()分析引用链。

如何排查workerman内存泄漏问题?内存持续升高怎么办?

Workerman内存持续升高,memory_get_usage()却没明显变化?这基本不是“内存没涨”,而是PHP引用计数未清、对象逻辑死亡但强引用链还在——得靠gc_collect_cycles()+xdebug_debug_zval()才能揪出来。

为什么memory_get_usage()看起来稳定,内存却越跑越高?

因为这个函数只统计当前脚本堆内存,不反映被闭包、静态属性、全局变量意外持有的“僵尸对象”。长连接场景下,一个TcpConnection对象被回调闭包捕获,又反过来持有$this,再指向self::$cache,就构成循环引用。GC默认不触发回收,memory_get_usage()自然“看不见”。

  • 每次业务逻辑结束前手动加gc_collect_cycles(),再用memory_get_peak_usage(true)打点对比
  • 别信memory_get_usage()单次值,重点看memory_get_peak_usage()随时间是否线性上升
  • 检查入口文件是否误调了gc_disable()——Workerman默认开启GC,关了等于放弃防线

静态变量和连接缓存怎么清理才安全?

Workerman进程常驻,static $connectionsself::$cache一旦写入不清理,就只增不减。尤其不能用$connection自身作数组键,它可能被其他闭包强引用,导致unset()无效。

Workerman
Workerman

最新主版本,继续强化高性能异步网络能力,适合 WebSocket、HTTP 服务、长连接、IM、IoT 等场景。 本次版本主要围绕稳定性、协议兼容以及连接处理能力优化,依旧保持超轻量和纯 PHP 特性。 适用于 PHP 8.x 环境,可配合 webman、GatewayWorker 等生态使用。

下载
  • onClose里必须配对unset(self::$connections[$connection->id]),键必须是可销毁的标量(如ID)
  • PHP 8.0+ 优先改用WeakMap$map = new WeakMap(); $map[$connection] = $context;,连接断开后自动解绑
  • 避免在onMessage或定时器里直接往静态数组[] =塞数据,除非你明确控制其生命周期

闭包、定时器和第三方SDK是泄漏高发区

闭包会隐式捕获作用域变量,Timer::add(1, [$this, 'tick'])比匿名函数更危险——它给实例加了一条强引用链,GC无法回收。

  • 定时器回调尽量写成静态方法或独立函数,别在类方法内定义闭包并引用$this
  • 连接关闭或状态切换时,务必调用Timer::del($timerId)主动销毁不再需要的定时器
  • Redis/HTTP SDK/数据库连接等必须手动释放:unset($this->redis)前先检查$this->redis->isConnected();EasyWeChat、阿里云SDK等要显式调用close()destroy()

怎么快速定位泄漏源头?

别靠猜。先用ps aux --sort=-%mem | head -10确认是哪个Worker进程在涨,再结合工具精准打击。

  • xdebug_debug_zval('your_var')查可疑对象的refcountis_ref,确认是否被意外持有
  • 启用swoole_tracker(需编译时开启tracker.enable_malloc_hook=1),捕获malloc/free不匹配
  • Hyperf用户可用内置Profiler组件查单次请求内存峰值;Workerman项目可加日志输出posix_getpid(),把内存打点和Worker ID绑定

最易被忽略的一点:SwooleTable或Redis连接池混用时,很多人忘了Workerman子进程各自初始化一份,new Swoole\Table必须严格限定在Worker::onWorkerStart里,且只通过global $table访问——在onMessage里重复new,等于每个请求都造一个新表。

相关文章

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

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

下载

相关标签:

workerman

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

相关专题

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

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

2026.05.20

41

15

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

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

2026.05.20

139

12

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

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

2026.05.20

62

13

Selenium WebDriver元素定位与页面操作教程
Selenium WebDriver元素定位与页面操作教程

本专题整理Selenium WebDriver元素定位、XPath、CSS Selector、等待机制、窗口切换、Frame处理、Alert弹窗、Cookie操作和文件上传等核心用法。

2026.08.05

0

26

Selenium Grid分布式测试与并行执行教程
Selenium Grid分布式测试与并行执行教程

本专题整理Selenium Grid架构、远程WebDriver、并行测试、Docker部署、Kubernetes动态Grid、浏览器矩阵和测试环境扩展方法,适合进阶自动化测试团队使用。

2026.08.05

0

18

Selenium常见报错排查与自动化测试稳定性
Selenium常见报错排查与自动化测试稳定性

本专题整理Selenium常见报错、驱动版本问题、元素找不到、点击失败、等待超时、浏览器闪退、脚本不稳定和测试用例维护方法。

2026.08.05

0

17

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

11

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

8

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

10

14

热门下载

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

精品课程

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

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

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

共0课时 | 0人学习