webman 默认monolog配置查bug效率低，因日志缺失文件名、行号、方法名，级别混存、控制台无颜色、多进程无标识；需手动配置introspectionprocessor、lineformatter占位符及filterhandler等实现精准定位与分级存储。
Webman 项目里直接改 config/log.php 就能用 Monolog，但想支持多 channel、精准定位、分级存储、控制台彩色输出，必须手动配置处理器链和 Formatter，不能只靠框架默认值。
为什么 Webman 的默认 Monolog 配置查 bug 效率低
默认日志不带业务文件名、行号、方法名，只显示框架层调用栈；所有级别日志混在一个文件里，ERROR 被 INFO 淹没；控制台输出全是白字，无法一眼识别错误级别；没有进程 ID 或线程标识，多 worker 场景下日志归属难追溯。
常见错误现象包括：Log::channel('api')->error('timeout') 写进去了，但翻日志时找不到对应行号，或发现 ERROR 日志和 DEBUG 日志挤在同一个大文件里，grep 耗时又不准。
- 默认
LineFormatter构造参数为空，不启用上下文字段（如%L%行号、%M%方法名） -
RotatingFileHandler默认未开启按级别分离，DEBUG和ERROR全部写入同一文件 - 控制台用
php://stdout但没配颜色标记（%start%/%end%），终端无高亮 - 缺少
ProcessIdProcessor，多进程日志无法区分来源
如何让 Log::channel('xxx') 精准记录到业务代码位置
关键不是改日志内容，而是让 Monolog 在记录时自动注入当前调用栈中的真实业务位置——这依赖 Formatter 的解析能力和 Processor 的上下文补充。
实操建议：
- 用
LineFormatter时，构造参数必须显式传入格式字符串，例如："%start%%datetime% [%P%] %level_name% %logger%:%L% - %message%%end%\n"，其中%L%和%logger%才能展开为真实文件行号与类名 - 必须添加
Monolog\Processor\IntrospectionProcessor，否则%L%、%M%全是??? - 确保 handler 的 level 参数 ≥ 实际调用级别，比如
RotatingFileHandler构造第三个参数设为Logger::DEBUG，否则debug()不会写入 - 不要在中间件或公共函数里提前调用
Log::info()，那里的%L%指向的是中间件文件，不是业务控制器
多个 channel 共享 formatter 但隔离 handler 怎么配
Webman 的 config/log.php 是返回一个数组，每个 channel 是独立 key。共享 formatter 可以避免重复定义，但 handler 必须各自实例化，否则多个 channel 写同一个文件会竞争或覆盖。
典型错误是把 StreamHandler 实例写成全局变量，在 config 文件里 new 一次然后复用——这会导致所有 channel 实际共用一个 handler 对象，日志错乱。
- 每个 channel 的
handlers数组里，class和constructor必须独立声明，不能引用外部变量 - formatter 可以抽成变量复用，例如：
$commonFormatter = ['class' => LineFormatter::class, 'constructor' => [...]];，再在各 handler 中引用 - 文件路径必须用绝对路径，推荐
runtime_path() . '/logs/xxx.log'，别用相对路径或__DIR__ - 若要 ERROR 单独存档，可套一层
FilterHandler：用['class' => FilterHandler::class, 'constructor' => [$handler, Logger::ERROR]]
自定义 channel 名称拼错导致日志静默丢失
Webman 的 Log::channel('xxx') 是纯字符串匹配，channel 不存在时不会报错，而是退化为 default 通道（如果配置了 fallback）或直接丢弃——这种静默失败最难排查。
容易被忽略的点：
- channel 名在
config/log.php的键名、Log::channel()的参数、以及插件配置（如webman-tech/logger）三处必须完全一致，大小写敏感 - 开发期建议在
support/facade/Logger.php里用 PHPDoc 注解声明方法，例如@method static void order($msg, ...)，让 IDE 提示补全，减少拼写错误 - 上线前加个简单校验：在
app/start.php里跑一遍array_keys(config('log'))，检查关键 channel 是否存在 - 不要在循环里高频调用
Log::channel('xxx')，它每次都会查找配置，有轻微开销；高频场景建议缓存Log::channel('xxx')返回的实例
最麻烦的其实是 formatter 字符串里那些占位符——%L% 看似简单，但缺了 IntrospectionProcessor 就永远是问号；%start% 颜色标记在某些终端（比如 Windows CMD）根本无效，得 fallback 到纯文本格式。这些细节不试一遍，光看文档根本踩不全坑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
