ThinkPHP 8.0 日志通道分离配置详解 排错

需在config/log.php的channels中显式注册小写通道名、path结尾带斜杠、type首字母大写为'File'、level用小写字符串数组，并确保目录可写；SQL日志分流需apart_level配置或单独建sql通道并手动监听。

想让支付日志、SQL日志、错误日志各自写进独立文件，却始终混在runtime/log/202607/下，或调用Log::channel('pay')->info()后根本没生成pay.log——问题不在代码调用，而在config/log.php里通道未显式声明、path结尾缺斜杠、type大小写错误，或PHP进程无目录写权限。

确认自定义通道已在 config/log.php 的 channels 中注册

打开项目根目录下的 config/log.php 文件，在 return 数组的 'channels' 键内，必须显式添加你的通道配置，例如：

复制以下内容到 'channels' 数组中（注意逗号位置）：

'pay' => [
    'type' => 'File',
    'path' => runtime_path() . 'log/pay/',
    'single' => true,
    'filename' => 'pay.log',
    'level' => ['info', 'error'],
],

立即学习“PHP免费学习笔记（深入）”；

【通道名必须全小写，且不能与内置 default、error 冲突】。若写成 'Pay' 或 'PAY'，调用 Log::channel('pay') 时会报 Channel [pay] is not exists —— ThinkPHP 启动时只读一次配置，动态用 Log::extend() 注册无效。

确保 path 以 / 结尾且目录可写

检查你为 pay 通道配置的 'path' 值：runtime_path() . 'log/pay/'。runtime_path() 返回值自带末尾 /，所以拼接后是 runtime/log/pay// —— 这没问题；但如果你手动写了 runtime/log/pay（不带尾部斜杠），ThinkPHP 会把日志写成 runtime/log/pay_pay.log，而不是你期望的 runtime/log/pay/pay.log。

执行命令验证目录是否存在并可写：

php think run "mkdir -p runtime/log/pay && chmod 755 runtime/log/pay"

如果 PHP 进程用户（如 www-data 或 nginx）对 runtime/log/pay/ 没有写权限，日志将静默丢失，不会报错，文件就是不生成。

设置通道级 level 并避开全局 level 干扰

ThinkPHP 8.0 的通道级 level 优先于全局 level，这是实现“支付日志记 info、主日志只收 error”的关键。

第一步：在 config/log.php 的全局配置中，将 'level' 设为底线级别，例如 ['error', 'critical']；

第二步：在 pay 通道内部单独配置 'level' => ['info', 'error']；

第三步：调用 Log::channel('pay')->info('订单创建成功')，这条 info 日志就会落地，哪怕全局 level 里没写 info。

注意：【level 必须是小写字符串数组，写成 'level' => 'info,error' 或 ['INFO','ERROR'] 都无效】。无效配置会导致该通道完全不写日志。

启用 SQL 日志分流需同时满足三个条件

方法一：用 apart_level 强制导出 SQL 到独立文件

在 config/log.php 的 file 通道配置中加入 'apart_level' => ['sql']，并确保：

① app_debug = true（仅开发环境有效，生产环境 APP_DEBUG=false 时 sql 日志直接被跳过）；

② 全局 'level' 数组中至少包含 'sql'（例如 'level' => ['info', 'error', 'sql']）；

③ 清空 runtime/cache/ 目录，否则旧缓存会让 apart_level 配置不生效。

方法二：为 SQL 单独建一个通道（推荐用于生产环境监控）

在 channels 中新增 'sql' 通道，type 设为 'File'，path 指向 runtime/log/sql/，level 设为 ['sql']；

然后在 Db 类中手动触发：Db::listen(function ($sql) { Log::channel('sql')->info($sql); });

这比依赖 apart_level 更可控，且不受 app_debug 开关限制。

验证日志是否真正分离

执行 php think clear:log 清除缓存；

触发一次支付逻辑（如调用 Log::channel('pay')->info('test')）；

立即检查 runtime/log/pay/pay.log 是否生成，且内容含 test 字样；

再触发一条 SQL 查询，检查 runtime/log/sql/sql.log 是否出现对应语句；

若 pay.log 为空，先确认 runtime/log/pay/ 目录存在且可写，再检查 config/log.php 中 pay 通道的 type 是否为 'File'（首字母大写，小写 'file' 会静默失败）。