Monolog日志未写入文件的主因是Handler未绑定或路径无写权限；须调用pushHandler()、确保目录存在且PHP进程可写、正确设置日志级别、使用支持上下文的Formatter，并做环境适配与错误检查。
Monolog 初始化失败：为什么 Logger 实例没写进文件？
常见现象是调用 info() 或 error() 后，日志文件空或根本没生成。核心原因通常是 Handler 没正确绑定，或者路径不可写。
-
StreamHandler的日志路径必须存在且 PHP 进程有写权限（比如/var/log/myapp/要先mkdir -p /var/log/myapp并chown www-data:www-data /var/log/myapp） - 别直接 new
Logger就完事——必须调用pushHandler()，否则日志无处可去 - 开发环境误用
NullHandler或忘记替换，也会静默丢日志
示例：
$logger = new Logger('app');
$handler = new StreamHandler('/var/log/myapp/app.log', Logger::DEBUG);
$logger->pushHandler($handler); // 这行漏掉就白搭
$logger->info('服务启动');
日志级别选错：INFO 写满磁盘，ERROR 却看不到关键报错
Monolog 默认只处理 >= 设置级别的日志，但很多人初始化时用 Logger::WARNING，结果 info() 全被过滤，而实际想看的调试信息全丢了。
- 开发阶段建议设为
Logger::DEBUG，上线后按需降级到Logger::WARNING或Logger::ERROR -
error()和critical()都会触发，但critical()会被监控系统更敏感捕获，适合服务完全不可用场景 - 别在循环里打
info()，尤其带变量拼接的——高频低价值日志会拖慢响应并撑爆磁盘
上下文数据丢失：为什么 context 数组里的字段没进日志文件？
Monolog 支持在 info() 等方法第二个参数传 array，但默认 Formatter（如 LineFormatter）可能只输出键名不输出值，或 JSON 格式被转义破坏结构。
- 确保用了支持上下文的 Formatter，比如
new LineFormatter(null, null, true, true)（最后两个true分别开启 include context 和 include extra） - 避免在 context 里传对象或资源句柄（如
mysqli实例），会触发__toString()或直接报错；先用get_object_vars()或json_encode()处理 - 如果用
RotatingFileHandler，注意它默认按天轮转，但 context 数据不会跨文件关联——查问题得盯准同一日期文件
多环境配置冲突：本地能写，线上 500 且无错误提示
最常踩的坑是线上环境禁用了 display_errors，又没配好 ErrorHandler，导致 StreamHandler 构造时因路径不存在或权限不足直接 fatal error，但页面只显示空白或 500。
立即学习“PHP免费学习笔记（深入）”；
- 初始化前加一层路径检查：
if (!is_writable(dirname($logPath))) { throw new RuntimeException("Log dir not writable: $logPath"); } - 生产环境务必把
Logger::ERROR以上级别同时推给SyslogHandler或NativeMailerHandler，避免日志文件出问题就彻底失联 - Composer 自动加载正常，但某些部署方式（如 phar 打包）可能漏掉 Monolog 的 handler 类，报
Class 'Monolog\Handler\StreamHandler' not found——确认vendor/autoload.php已引入且无路径偏移
日志不是写进去就完事，关键是让它在出问题时真能被看到、能定位到那一行代码和当时的变量状态。路径权限、级别阈值、上下文序列化、环境隔离——四个点漏一个，排查时就得多花三倍时间翻配置。
