ThinkPHP日志打爆磁盘的根本原因在于max_files未生效、file_size配置不合理或Log::record()在长任务中内存堆积。max_files仅在File驱动且single=false、path可写、CLI与Web路径一致时才触发;file_size建议设为1MB–2MB,max_files配100–30;长任务须手动调用Log::save()或改用Log::write()实时落盘,并确保storage/logs目录权限正确。

ThinkPHP 日志打爆磁盘,根本不是“日志太多”这个表象问题,而是 max_files 没生效、file_size 设得不合理、或 Log::record() 在长任务中持续堆积内存——三者任一失控,都会让日志无声吃光磁盘。
log.php 中的 max_files 为什么没起作用
这个参数只对 File 驱动下的「按日期分目录 + 按大小切文件」模式有效,但前提是:single 必须为 false(默认值),且 path 路径可写、有实际文件生成。
- 如果误设了
'single' => true,所有日志都往一个文件里追加,max_files完全不触发清理逻辑 - 如果
path指向了不可写的目录(比如storage/logs权限是755但属主不是www-data),日志写入失败,既不报错也不清理,max_files形同虚设 - 如果项目启用了 CLI 命令(如定时任务),而 CLI 环境下
LOG_PATH和 Web 不一致,max_files实际控制的是另一套路径,和你看到的 runtime/log 目录无关
file_size 和 max_files 怎么配才不踩坑
这两个参数要配合磁盘容量和请求频率一起算:单文件太大,轮转慢,容易单点撑爆;太小,文件碎片多,Linux 下 inode 耗尽比磁盘满更隐蔽。
- 常规 Web 服务建议设为
file_size => 2097152(2MB),max_files => 30—— 对应约 60MB 日志总量,适合中小流量项目 - 高并发 API 服务建议压到
file_size => 1048576(1MB),max_files => 100,避免单次写入阻塞过久 - 千万别用
file_size => 0或留空,TP 不会自动设默认值,而是退化为无限大单文件 -
max_files清理是「新文件生成时检查旧文件数」,不是定时扫描,所以低流量站点可能几天都不触发清理
长任务(如队列消费者、导出脚本)日志内存泄漏
TP 5.1+ 的 Log::record() 默认把日志暂存在 self::$log 数组里,直到 Log::save() 被调用。但在 CLI 长循环中,如果不主动调用 save(),数组会越积越大,最终 OOM。
立即学习“PHP免费学习笔记(深入)”;
- 在循环体末尾手动加
\think\Log::save();,强制刷出并清空内存 - 或者改用
\think\Log::write(),它默认实时落盘(V5.1.15+ 不再触发save(),更可控) - 开发期开启
APP_DEBUG = true时,SQL 日志、行为日志会大量注入,务必在长任务前临时关闭:define('APP_DEBUG', false) - 别信“框架会自动清理”,
Log::record()的内存暂存机制不会自己释放,除非你调用save()或请求生命周期结束
别依赖 clear_time 这种伪配置
有些老教程提到在 config.php 里加 'clear_time' => 1,这是 ThinkPHP 3.x 的遗留字段,TP6 完全不识别,写了等于注释。
- TP6 唯一有效的自动清理,只来自
channels.file.max_files配合正常日志写入流程 - 真要按天清理,得自己写命令行指令,比如在
app/command/ClearLog.php里用Filesystem扫描runtime/log下早于 N 天的子目录并删除 - 生产环境建议搭配系统级 logrotate,而不是靠 PHP 自身逻辑,避免 PHP 进程卡住时清理失效
最常被忽略的一点:日志路径权限问题不是“有没有报错”,而是“静默丢弃”。storage/logs 目录属主不对,max_files 再怎么配都白搭——先确认 ls -ld storage/logs 输出里运行 PHP 的用户能写,再调参数。



















