Workerman集成Monolog需配置IntrospectionProcessor和LineFormatter实现精准定位，用FilterHandler分级存储，JSON日志需LineFormatter输出结构化字符串，多进程下须避免RotatingFileHandler竞态。
Workerman 本身不内置 Monolog，但可以无缝集成——关键不是“能不能用”，而是“怎么配才能让 Log::channel('api') 写出的日志带行号、按级别分离、支持 JSON 结构化、还能在多进程下不乱序不覆盖”。
为什么直接 new Logger() + StreamHandler 会出问题
常见错误现象：日志写进文件后内容错位、同一秒出现两条不同进程的 INFO 挤在同一行、Log::channel('pay')->error() 的行号显示的是 Workerman 底层文件而非你的支付控制器。
根本原因有三个：
- StreamHandler 默认不加锁，多进程并发写入时会触发系统级 write() 竞态，导致内容截断或混行
- 没加
IntrospectionProcessor，%L%和%M%全是??? - 没设
RotatingFileHandler的$level参数（第三个构造参数），比如设成Logger::ERROR，那info()就直接被过滤掉了，不是没写，是压根没传给 handler
必须配置的 Processor 与 Formatter 组合
Monolog 的定位能力不靠日志内容，靠 Processor 注入上下文 + Formatter 解析占位符。缺一不可。
实操建议：
- 一定要注册
Monolog\Processor\IntrospectionProcessor，且构造时传['vendor/workerman', 'vendor/monolog']排除框架路径，否则%L%指向的是Worker.php而不是你的PayController.php -
LineFormatter的格式字符串必须显式传参，例如："%datetime% [%P%] %level_name% %logger%:%L% - %message%\n"，空字符串或默认值会导致%L%不展开 - 若要终端彩色输出，格式里得含
%start%/%end%，并确保 handler 用的是StreamHandler（非RotatingFileHandler），因为后者不支持颜色转义
多 channel 分级存储的正确写法
不是简单地为每个 channel 新建一个 RotatingFileHandler，而是要用 FilterHandler 套一层，否则 ERROR 日志会同时出现在 api.log 和 error.log 里。
实操建议：
- 定义
errorchannel 时，handler 链应为：FilterHandler→RotatingFileHandler，其中FilterHandler构造参数传Logger::ERROR，这样它只放行 ERROR 及以上级别 - 定义
debugchannel 时，RotatingFileHandler构造第三参数设为Logger::DEBUG，并配合maxFiles限制为 30 天，避免磁盘撑爆 - 所有 handler 的
filename必须用绝对路径，例如：runtime_path().'/logs/pay_error.log'，相对路径在多进程下容易因工作目录不同而写错位置
JSON 格式日志用于 ELK/Loki 检索
结构化日志不是为了好看，是为了让 grep 升级成 Kibana 查询。但直接用 JsonFormatter 会丢掉 %L% 和 %M% —— 因为它不解析 LineFormatter 占位符。
实操建议：
- 不要用
JsonFormatter替代LineFormatter，而是用LineFormatter输出 JSON 字符串，格式字符串设为：'{"time":"%datetime%","pid":%P%,"level":"%level_name%","file":"%logger%","line":%L%,"msg":"%message%"}' . "\n" - 确保
IntrospectionProcessor已启用，否则"file"和"line"字段全是空或??? - 生产环境禁用
StreamHandler（控制台输出），只保留RotatingFileHandler或SocketHandler（对接 Loki）
最易被忽略的一点：Workerman 多进程下，RotatingFileHandler 的日志轮转不是原子的。两个进程同时检测到文件超限，可能都执行 rename，导致一条日志丢失。真正安全的做法是用主进程统一做日志归档，或改用 syslog / Filebeat 采集，而不是依赖 PHP 层轮转。
