Laravel如何实现按业务分类记录日志的自定义日志通道功能？

本文共计1063个文字，预计阅读时间需要5分钟。

直接修改配置文件，添加一个通知配置行：

常见错误是只加了通道名但没指定 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') 快速验证。