ThinkPHP 8.0 日志级别必须在 config/log.php 中以小写字符串数组形式硬编码配置，.env 中的 LOG_LEVEL 环境变量不被读取；APP_DEBUG=false 时 debug/info 日志即使配置也会被框架拦截。
Env 配置日志级别本身不生效——ThinkPHP 8.0 的 level 必须写在 config/log.php 里，且必须是小写字符串数组；环境变量（如 .env）无法直接驱动日志级别过滤逻辑。
为什么 .env 里的 LOG_LEVEL=debug 没用
ThinkPHP 8.0 不读取 LOG_LEVEL 这类环境变量来控制日志输出级别。框架启动时只加载 config/log.php 中的 channels 配置，level 字段必须显式声明为数组，例如 ['debug', 'info']。写成 LOG_LEVEL=debug,info 或 LOG_LEVEL="['debug','info']" 在 .env 里，不会被自动解析进日志通道配置。
-
log.php中的level是硬编码配置项，不支持从 Env 动态注入 - 试图用
Env::get('LOG_LEVEL')手动拼进level数组会失败——因为配置文件加载早于 Env 初始化完成，且数组结构必须在定义时就确定 - 有些旧教程提到
LOG_RECORD或LOG_LEVEL，那是 TP5/6 早期行为，TP8 已移除该机制
想按环境区分日志级别，只能改 config/log.php
开发、测试、生产环境的日志级别差异，必须在 config/log.php 中通过 PHP 代码分支实现，而不是靠 .env 变量驱动：
- 用
Env::get('APP_ENV')判断当前环境（需确保think\facade\Env已加载） - 不能直接写
'level' => Env::get('APP_ENV') === 'production' ? ['error'] : ['debug','info']——因为log.php是纯配置文件，不执行函数调用 - 正确做法：在
config/log.php顶部加use think\facade\Env;，再用三元表达式构造数组（TP8 允许）
return [
'default' => 'file',
'channels' => [
'file' => [
'type' => 'File',
'path' => runtime_path() . 'log/',
'level' => Env::get('APP_ENV') === 'production'
? ['error', 'critical', 'alert', 'emergency']
: ['debug', 'info', 'warning', 'error'],
],
],
];
常见踩坑点：level 写错导致 Log::debug() 完全不落地
哪怕你确认 APP_ENV=development，只要 level 配置不对，Log::debug() 就静默丢弃：
立即学习“PHP免费学习笔记（深入）”；
-
'level' => 'debug'❌ —— 必须是数组，单字符串被忽略 -
'level' => 'debug,info,error'❌ —— 字符串逗号分隔不识别 -
'level' => ['Debug', 'Info']❌ —— 级别名必须全小写，大写被跳过 -
'level' => []✅ —— 关闭该通道所有日志，但容易误配成空数组 - 没清缓存：改完
log.php后必须运行php think clear:log，否则旧配置仍生效
真正需要 Env 控制的，其实是 app_debug 和 APP_ENV
虽然日志 level 不能由 Env 直接驱动，但两个关键开关必须靠 .env 控制，否则 level 配置也白搭：
-
APP_DEBUG=true—— 决定是否启用sql日志和详细堆栈；APP_DEBUG=false时，debug/info即使在level数组里也不会写入 -
APP_ENV=production—— 影响框架默认行为（比如自动关闭调试日志），也常被用于条件加载不同log.php分支 -
LOG_CLOSE=true这类变量在 TP8 中已废弃，不要在.env里写
最易被忽略的是：app_debug 关闭后，level 里写的 debug 和 info 直接失效——这不是配置错误，而是框架强制拦截。所以检查日志前，先确认 php think env:get APP_DEBUG 输出是否为 true。
