ThinkPHP 8 自定义日志通道必须在 config/log.php 的'channels'中显式声明，且默认单文件日志大小限制为 2097152 字节。

原因分析

ThinkPHP 日志系统启动时只读一次配置，后续动态注册通道在 CLI 或 FPM 长生命周期下容易失效。2026 年 4 月 10 日的日志处理文档指出，系统在进行日志写入之前会读取配置文件进行初始化，若未在配置文件中预定义通道，代码中调用 Log::channel() 将无效。此外，V5.1.8+ 版本引入了 close 参数用于控制是否关闭日志写入，若配置不当会导致日志静默失败。

解决方案

1. 配置文件显式声明通道

在 config/log.php 的'channels'数组中显式声明自定义通道，例如支付模块日志：'pay' => [ 'type' => 'single', 'path' => runtime_path() . 'log/pay/', 'level' => 'info' ]。2026 年 3 月 27 日的配置指南强调，不改这个文件光在控制器里调用 Log::channel() 是没用的，通道根本没注册进去。

2. 代码中切换通道写入

在业务代码中使用 Log::channel('pay')->info('xxx') 指定通道。若配置未生效，常见报错信息为 Channel [pay] is not exists。确保该通道未被提前初始化，避免 Log::init() 时加载了 default 覆盖。

3. 争议方案：动态注册 vs 静态配置

部分开发者尝试在中间件里用 Log::extend() 动态注册，但 2026 年 3 月 27 日的资料指出这在多请求复用进程的 Swoole 场景下会丢通道。推荐在 app\common\middleware\InitLogChannel 中间件里做通道切换，而非全局配置一堆静态通道。

注意事项

• 路径末尾斜杠：path 值必须以/结尾，否则 ThinkPHP 会拼错路径，例如写成 runtime/log/pay_pay.log 而非预期目录。
• 权限与 SELinux：Linux 下写入失败多数是 SELinux 或用户权限不匹配，SELinux 环境下需用 chcon -R -t httpd_log_t 修复上下文权限。
• 版本特性差异：V5.1.6+ 版本支持 max_files 参数超过自动清理，V5.1.8+ 支持 close 参数，配置时需核对框架版本。
• 调试建议：关闭自动轮转临时排查，设置'max_files' => 0，看是否固定写入 2024-06-01.log 成功。

参考来源

来源：ThinkPHP 如何自定义日志通道_ThinkPHP 多日志文件输出配置【指南】 - 2026 年 3 月 27 日更新

来源：日志处理 - 2026 年 4 月 10 日发布

来源：ThinkPHP 在不同系统下的日志文件目录配置_写入权限排查 - 2026 年 4 月 6 日记录