应停用think\Log默认文件驱动,改用Redis异步队列投递日志;需自定义AsyncLog门面拦截日志调用,由queue:work进程消费落盘,并监控Redis队列长度、内存水位及消费者状态。

日志写入阻塞请求响应,think\Log 默认同步刷盘太慢
ThinkPHP 6/7 的 think\Log 默认走文件驱动,每次 Log::info() 都会触发一次磁盘 I/O,高并发下直接拖垮接口响应——不是日志没记,是请求卡在 flock() 和 file_put_contents() 上。尤其当多个进程争抢同一个日志文件(如 runtime/log/202406/xxx.log)时,WARNING: flock() has been disabled for security reasons 这类报错反而只是表象,真正问题是锁等待叠加磁盘吞吐瓶颈。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 立刻停用
FileDriver作为生产环境主日志通道,哪怕只保留StdoutDriver临时打屏,也比阻塞强 - 确认当前日志配置是否启用了
single模式('single' => true),该模式虽减少文件数量,但加剧单文件竞争,高并发下更危险 - 不要试图通过增大
max_files或改名daily来“缓解”——这只是把问题摊薄,没解决同步 I/O 根源
用 think-queue + Redis 实现日志异步投递
ThinkPHP 官方队列扩展 think-queue 是最轻量接入方案,无需引入 Kafka 或 RabbitMQ。核心思路:把 Log::info() 替换为向 Redis 队列推一条结构化日志消息,由独立的 queue:work 进程消费并落盘。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 安装:
composer require topthink/think-queue,配置config/queue.php中'default' => 'redis',确保redis连接正常 - 定义日志任务类(如
app/job/AsyncLogJob.php),handle()方法里调用Log::channel('file')->info(...),避免循环触发队列 - 关键参数:设置
attempts为1(日志丢了比重试更重要),delay设为0,不加延迟 - 启动消费者:
php think queue:work --daemon --queue=async_log,务必加--daemon,否则每次请求都 fork 新进程,内存爆炸
Log::record() 被绕过?自定义日志门面必须重写 __callStatic
直接调 Log::info() 不会自动进队列——因为框架底层仍走 think\Log 的同步逻辑。你得拦截所有日志调用,把它们转成队列任务。不能靠中间件或事件监听,必须从门面入口下手。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 新建
app/facade/AsyncLog.php,继承think\Facade,重写getFacadeClass()返回你自己的日志代理类 - 代理类(如
app/common/LogProxy.php)中,__call()方法捕获info/error等调用,组装数据后丢进Queue::push(new AsyncLogJob($data)) - 别漏掉
Log::init()和Log::close()——它们不走__call,需单独代理,否则初始化失败或关闭时丢失日志 - 测试时用
Log::getLevel()确认当前通道是否已切换,避免误以为生效了其实还在打文件
Redis 队列积压导致日志延迟甚至丢失
异步不是万能解药。如果 queue:work 进程挂了、Redis 内存满了、或消费者处理速度跟不上生产速度,日志就会堆在 redis list 里,LLEN think_queue_async_log 超过 1w 就该警觉。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 加监控:用
crontab每分钟跑redis-cli -h xxx LLEN think_queue_async_log,超阈值发告警 - 设置 Redis
maxmemory-policy为noeviction,宁可写入失败也不能让日志被 LRU 清掉 - 消费者异常退出时,
queue:work不会自动重连 Redis,建议用supervisord管理进程,崩溃后秒级拉起 - 别依赖队列保证 100% 投递——关键错误(如数据库连接失败)仍建议双写:先同步写
error_log,再异步补全上下文
异步日志真正的复杂点不在代码怎么写,而在于你得同时盯住三个地方:应用层的日志调用是否真进了队列、Redis 的队列长度和内存水位、消费者进程的存活与处理耗时。少盯一个,日志就悄无声息地消失在某个环节里。



















