workerman日志膨胀源于未做生命周期管理,需先定位日志路径(默认走php error_log),再停写+安全轮转,最后配置logrotate自动轮转并精简无效日志。

Workerman主动推送信息时产生的日志文件持续膨胀,导致磁盘IO升高、写入延迟加剧,甚至触发系统级磁盘满告警——这不是日志内容太多的问题,而是日志未做生命周期管理的直接后果。
确认日志是否真由Worker::log()产生
打开你的start.php或主启动文件,搜索Worker::$logFile赋值语句。如果没找到,说明你当前用的是默认行为:所有Worker::log()输出都走PHP的error_log()通道,最终落进php.ini里error_log配置指向的文件(通常是/var/log/php_errors.log或/var/log/apache2/error.log)。这和Workerman自定义日志是两套路径,清理前必须分清。
运行php --ini查加载的php.ini路径,再用grep "error_log" /etc/php/*/apache2/php.ini(或cli子目录)定位真实PHP错误日志位置。
立即停写+轮转现有日志文件
第一步:临时禁用Worker::log()写入,避免边清理边增长。
在start.php最开头(use Workerman\Worker;之后、Worker::runAll()之前)插入:
Worker::$logFile = '/dev/null';
第二步:对已存在的大日志文件执行安全轮转。
假设你的日志路径是/var/log/workerman/app.log,执行:
① mv /var/log/workerman/app.log /var/log/workerman/app.log.20260806
② touch /var/log/workerman/app.log
③ chown www-data:www-data /var/log/workerman/app.log(用户组需与Workerman进程一致)
【注意:不要用 > /var/log/workerman/app.log 清空,会导致正在写入的日志丢失且进程句柄仍指向原inode,磁盘空间不会释放】
配置自动轮转防止复发
方法一:用Linux自带logrotate(推荐)
新建/etc/logrotate.d/workerman,内容如下:
/var/log/workerman/*.log {<br> daily<br> missingok<br> rotate 30<br> compress<br> delaycompress<br> notifempty<br> create 0644 www-data www-data<br> sharedscripts<br> postrotate<br> systemctl reload workerman.service > /dev/null 2>&1 || true<br> endscript<br>}
方法二:代码层加判断(仅适用于可控场景)
在Worker::$logFile赋值后、Worker::runAll()前加入:
$logPath = '/var/log/workerman/app.log';<br>if (file_exists($logPath) && filesize($logPath) > 100 * 1024 * 1024) {<br> rename($logPath, $logPath . '.' . date('YmdHis'));<br>}
这一步只在每次启动时检查,无法解决运行中单次写入超大的问题,慎用。
从源头减少无效日志
检查所有调用Worker::log()的地方,特别是推送逻辑中高频触发的位置——例如每条消息都打一次Worker::log("push to uid {$uid} success"),这种日志对运维无实际价值,只会制造噪音。
将调试级日志改为条件输出:
if (defined('DEBUG') && DEBUG) {<br> Worker::log("push to uid {$uid} success");<br>}
生产环境启动前确保define('DEBUG', false);已设置。
推送失败才记录关键错误:
if (!$result) {<br> Worker::log("push failed for uid {$uid}, error: " . $connection->getErrorMessage());<br>}











