在 Laravel 中新增自定义日志通道需在 config/logging.php 中配置驱动（如 single/daily）、路径、格式器等，通道名须小写无点号，配置后执行 php artisan config:clear，并通过 Log::channel('xxx') 显式调用，注意权限、level 和性能。
怎么在 Laravel 中新增一个自定义日志通道
直接改 config/logging.php，加一个通道配置就行。Laravel 的日志系统是基于 Monolog 构建的，所有通道最终都会映射到 Monolog 的 Handler，所以关键不是“写新代码”，而是“配对 Handler 和 Formatter”。
常见错误是只加了通道名但没指定 driver，或者写了 driver => 'single' 却没配 path，结果日志写不进去也不报错。
- 必须指定
driver：比如'driver' => 'single'、'driver' => 'daily'或'driver' => 'stack' - 如果用
single或daily，必须提供path（如storage_path('logs/payment.log')） - 通道名不能含点号或大写字母，否则
Log::channel('pay-ment')会静默失败 - 配置完别忘了清缓存：
php artisan config:clear，否则新通道不生效
如何让不同业务模块写到不同日志文件
靠 Log::channel('xxx') 手动指定通道最稳妥。不要试图在中间件或全局事件里“自动切换通道”，那会污染调用链、干扰异步任务和队列消费。
典型场景是支付回调、用户注册、库存扣减这些高敏感操作，各自需要隔离的日志路径和格式。
- 在支付回调逻辑里写：
Log::channel('payment')->info('Alipay notify received', $data) - 在
config/logging.php里为payment通道启用'daily'驱动，避免单文件爆炸 - 注意
context数组里的数据不能含闭包、资源或未序列化对象，否则 Monolog 序列化时报错：Exception: Object of class Closure could not be converted to string - 如果要用 JSON 格式输出（方便 ELK 收集），给通道加
'formatter' => \Monolog\Formatter\JsonFormatter::class
为什么 Log::channel('xxx') 有时不写日志
不是代码没跑，大概率是通道配置无效或权限问题。Laravel 不会在通道不存在时抛异常，而是 fallback 到默认通道（甚至静默丢弃）。
最容易被忽略的是日志目录权限和 SELinux（尤其在 CentOS 上）。开发环境能写，上线后突然不写，90% 是这个原因。
- 检查
storage/logs/目录是否可写：ls -ld storage/logs，Web 用户（如 www-data）必须有写权限 - 运行
php artisan tinker，手动执行Log::channel('xxx')->debug('test')，看对应文件有没有生成 - 如果文件生成了但内容为空，可能是
level配置太高（比如设成'level' => 'error'，但你打的是info） - 在队列任务中使用自定义通道时，确保
APP_ENV和LOG_CHANNEL环境变量与配置一致，别让队列 worker 读错配置
Laravel 日志通道性能要注意什么
日志写入是 I/O 密集型操作，尤其在高频请求或循环体里频繁调用 Log::channel()->xxx()，会明显拖慢响应。
不是不能写，而是得控制粒度和时机。比如订单创建流程里，记录“下单成功”比每一步校验都记一条更合理。
- 避免在 for 循环内打日志；改用聚合后一次性记录：
Log::channel('order')->info('Order created', ['items' => $itemIds]) - 不要在
__destruct或模型事件里写自定义通道日志，可能因对象状态不稳定导致写入失败 - 如果用
daily驱动，注意 Laravel 默认按 UTC 时间切分文件；国内项目建议加'timezone' => 'Asia/Shanghai'避免凌晨三点切日志 - 生产环境慎用
stack通道嵌套多个 handler（比如同时写文件 + 推送 Slack），失败一个会导致整条日志丢失
通道越多，配置越容易漏掉 path 或写错 level，上线前最好用一个脚本遍历所有通道，调用 Log::channel($name)->debug('health-check') 快速验证。
