日志不生成文件的核心原因有三:目录不可写(storage及子目录权限/属主不匹配Web进程用户)、日志级别被过滤(config/log.php中level设置过高)、驱动被运行时切换(如Log::driver('socket')覆盖为非文件驱动)。

日志不生成文件,核心就三件事:目录不可写、级别被过滤、驱动被切换。不是代码没调用,而是框架压根没走到落盘那步。
storage/logs 目录权限是否真正可写
Linux 下 Web 进程用户(如 www-data 或 nginx)必须对 整个 storage 目录 有写权限,不只是 logs 子目录。runtime 目录也要可写,否则连日志文件都创建不了。
- 执行
ls -ld storage和ls -ld storage/logs,确认属主和权限匹配当前 PHP 进程用户 - 临时验证可用:
sudo chown -R www-data:www-data storage(Ubuntu/Debian)或sudo chown -R nginx:nginx storage(CentOS) - Docker 环境要检查挂载卷的 UID/GID 是否与容器内 Web 用户一致,chown 可能无效
log.level 设置是否允许当前日志级别写入
ThinkPHP 日志是“门禁式”控制:低于 level 阈值的日志连磁盘 I/O 都不会发起。Log::info() 没反应,大概率是配置里设了 'level' => 'error'。
- 检查
config/log.php中的level值,开发期建议设为'debug',生产环境至少'warning' - 注意:level 是“最低记录门槛”,
'warning'表示只记 warning、error、critical,不记 info 或 debug -
APP_DEBUG只影响错误页面展示,和日志写入无关
Log::driver() 是否被运行时代码覆盖
很多人只改了 config/log.php,却在中间件、app/common.php 或命令行脚本里显式调用了 Log::driver('socket'),导致后续所有日志都走 socket 驱动——而 log-server 没起,日志就静默丢弃。
立即学习“PHP免费学习笔记(深入)”;
- 全局搜索项目中是否出现
Log::driver(,尤其检查中间件、命令类、单元测试入口 - 确认
config/log.php中'default' => 'file',且没被运行时代码覆盖 -
'type' => 'trace'或'type' => 'test'是内存驱动,不落盘;线上误配等于关掉日志
CLI 模式下路径是否对当前用户可写
TP6 在 CLI 和 Web 下共用同一套日志配置,但 CLI 进程用户(如 root)和 Web 用户(如 www-data)往往不同。如果 storage/logs 对 CLI 用户不可写,php think hello 里的 Log::info() 就会静默失败。
- 不要依赖 Web 环境下的权限设置来保 CLI 日志
- 要么统一属主(如都设为 www-data),要么给 CLI 单独配路径
- 可临时用
sudo -u www-data php think hello测试是否权限问题



















