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

想让支付日志、SQL日志、错误日志各自写进独立文件？结果全混在 runtime/log/202607/ 下，或者调用了 Log::channel('pay')->info() 后，发现 pay.log 根本没生成？问题根源往往不在你的代码调用上，而是出在 config/log.php 的配置细节里。

实际上，解决方案并不复杂，但需要逐一排查几个关键点：通道是否显式声明、路径结尾是否带斜杠、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'],
],

这里有两个硬性要求：通道名必须全小写，且不能与内置 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' 会静默失败）。