生产环境必须关闭app_debug并设置log.level为['error','critical','alert','emergency']，否则level配置失效；log::error()不写入文件的常见原因包括默认channel未配、type大小写错误、level非数组、目录无写权限及apart_level与level混淆。
生产环境必须设 log.level 为 ['error', 'critical', 'alert', 'emergency']，且前提是 app_debug 已关——否则所有级别日志照常写入，level 配置完全失效。
为什么 Log::error() 写不进文件？先查这三处
不是代码错了，而是配置链断在某个环节。常见静默失败原因：
-
config/log.php中'default' => 'file'没配，或'channels.file.type'写成'file'（应为'File'，大小写敏感） -
'level'数组为空或没包含'error'，比如写成'level' => 'error'（字符串）——必须是数组：'level' => ['error'] -
runtime/log/目录对 Web 进程用户（如www-data）无写权限，rename 失败后 TP 不报错，日志直接停更
apart_level 和 level 的区别必须分清
level 是全局门禁：不在列表里的级别，连日志缓冲区都不进；apart_level 是分流通道：即使 level 没开 'info'，只要 'apart_level' => ['info'] 且 app_debug = true，Log::info() 仍会单独写进 info.log。
-
sql级别只受app_debug控制，和level无关——这是最常踩的坑 - 生产环境若开了
'apart_level' => ['sql']，但app_debug = false，那 SQL 日志根本不会产生，不用删配置 - 想让某级别既进主日志又单独成文件？得同时加进
level和apart_level
高频接口里别靠 level 过滤调试日志
哪怕 level 设为 ['error']，只要代码里写了 Log::info('xxx')，TP 仍会执行变量格式化、上下文合并、级别比对——这部分开销在每秒上千请求时很可观。
- 用
if (app()->isDebug()) { Log::debug('xxx'); }替代无条件调用 - 检查中间件、模型事件、循环体内部，删掉所有非必要的
Log::info()或Log::debug() - 审计类日志（如“用户修改密码”）别走
Log::info()，改用数据库表记录，绕过整个日志系统
真正要关日志，不是调低 level，而是设 'type' => 'none'——它跳过初始化、不建缓冲区、Log:: 所有方法都直接返回，但注意：trace() 和异常页面会丢上下文，别在需要调试追踪的环境用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
