thinkphp 8.0 日志 level 必须为小写字符串数组，如 ['debug','info']；单字符串或大小写错误均无效，且通道需在 config/log.php 的 channels 中显式声明，type 首字母大写，path 以 / 结尾并确保目录可写。
config/log.php 里 level 必须是数组，不是字符串
写成 'level' => 'error' 或 'level' => 'debug,info,error' 都无效——ThinkPHP 8.0 只认数组。配置被忽略后，日志会按默认行为（通常是 ['error', 'warning', 'info']）写入，导致 Log::debug() 不落地、Log::info() 却意外刷屏。
-
'level' => ['debug', 'info', 'warning', 'error']是开发环境常用写法 -
'level' => ['error', 'critical', 'alert', 'emergency']是生产环境底线 - 空数组
[]表示关闭该通道所有日志，慎用 - 级别名必须小写，
'Error'或'INFO'会被跳过
自定义通道必须在 config/log.php 的 channels 里显式声明
调用 Log::channel('pay')->info('xxx') 却没生成文件？大概率是 'pay' 根本没在 config/log.php 的 'channels' 数组里注册。ThinkPHP 启动时只读一次配置，运行时用 Log::extend() 注册的通道在 CLI/FPM/Swoole 下极不稳定，尤其多请求复用进程时会丢通道。
- 通道名全小写，避免和内置
'default'、'error'冲突 -
'type'值必须首字母大写：'File'✅，'file'❌（静默失败） -
'path'必须以/结尾，例如runtime_path() . 'log/pay/'，否则路径拼接出错 - 确保目标目录存在且 PHP 进程有写权限，否则日志静默丢失（不报错）
apart_level 和 level 是两套逻辑，别混用
'apart_level' => ['sql'] 不受 level 控制，但强依赖 app_debug = true。很多人设了 apart_level 却发现 sql.log 没内容，其实是生产环境 APP_DEBUG=false 导致 SQL 日志根本没触发。
-
level是过滤器：决定哪些级别“能进通道” -
apart_level是分流开关：把指定级别强制导出到独立文件（绕过level过滤） -
sql级别只在调试模式生效，emergency、alert等标准级别才走level判断 - 修改
apart_level后，必须清空runtime/cache/，否则旧缓存可能让配置不生效
通道级 level 优先于全局 level
全局 'level' => ['error']，但某个通道单独配了 'level' => ['debug', 'info']，那这个通道真会记 Log::debug() ——哪怕其他通道完全收不到。这是实现“支付日志记 info、错误日志只收 error”的核心机制。
- 未定义
level的通道自动继承全局配置 - 通道级
level只影响该通道，不影响其他通道或日志分发逻辑 - 不要用
Log::setLevel()动态改——它只作用于默认通道，且对已初始化的通道无效 - 环境适配推荐写法：
'level' => env('APP_DEBUG', false) ? ['debug','info','warning','error'] : ['warning','error']
php think clear:log 清缓存；路径权限、大小写、数组结构这三处最容易漏查，问题往往不出在代码逻辑，而出在这三个地方。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
