Laravel日志配置详解【追踪】

本文深入解析 Laravel 日志系统的配置逻辑与常见陷阱，直击“日志写不进 storage/logs/”这一高频问题——根本原因往往不在代码，而在权限设置、LOG_CHANNEL 配置错位（如误设为 stderr）、或 logging.php 中 channel 驱动未正确指向文件型通道（single/daily）；文章手把手指导如何按环境精准切分日志策略（开发用 stack+stderr+single，生产用 daily+error 级别），详解自定义通道（如 audit 日志）的独立 level 控制、结构化记录与告警集成，并揭示自动记录 SQL 查询的可靠方案（依赖 DB_LOG_QUERIES + LOG_LEVEL 联动而非手动调试），帮你告别日志丢失、定位混乱和配置踩坑，真正实现可追踪、可隔离、可运维的日志治理。

日志写不进 storage/logs/，八成是权限、LOG_CHANNEL 配置或驱动路径没对上；不是代码写错了，而是环境和配置没对齐。

为什么 storage/logs/laravel.log 没更新？

最常见原因就三个：目录不可写、日志被重定向到 stderr、或者 channel 配置压根没指向文件驱动。

• storage/ 目录必须对 Web 服务器用户（如 www-data 或 nginx）可写，用 chmod -R 775 storage/ 更安全，别直接 777
• 检查 .env：如果设了 LOG_CHANNEL=stderr，日志会输出到标准错误流（比如 Docker 的 docker logs），不会落盘——这不是 bug，是目标变了
• 看 config/logging.php 中 'default' => env('LOG_CHANNEL', 'stack')，再确认 'stack' 的 channels 数组里是否真包含 'single' 或 'daily' 这类文件驱动

怎么按环境切 daily / single / stack？

不用改代码，全靠 .env 和 config/logging.php 联动控制。

• 开发环境推荐：LOG_CHANNEL=stack + LOG_LEVEL=debug，stack 的 channels 包含 ['single', 'stderr']，方便终端实时看 + 文件留存
• 生产环境建议：LOG_CHANNEL=stack，但 stack 的 channels 改成 ['daily']，并设 LOG_LEVEL=error 减少 I/O 压力
• 'daily' 通道可配 'days' => 14 控制保留天数，避免日志无限膨胀

Log::info() 和 Log::channel('xxx')->info() 有什么实际区别？

前者走默认通道（通常是 stack），后者强制指定通道，本质是路由分流，不是功能差异。

• 想隔离审计日志？先在 config/logging.php 的 channels 里加一个 'audit'，driver 设为 'single'，path 指向 storage_path('logs/audit.log')
• 调用时写 Log::channel('audit')->info('user_id: '.$userId, ['action' => 'delete_post'])，结构化数据会自动 JSON 化
• 注意：audit 通道不会继承 stack 的 Slack 处理器，要发告警得单独配 slack 驱动或复用已有 handler

怎么让 SQL 查询自动进日志？

别手动调 DB::enableQueryLog()，那只是临时调试手段；真正轻量又稳定的方案是配环境 + DB 配置。

• 确保 APP_DEBUG=true 且 LOG_LEVEL=debug，Laravel 会在 debug 级别自动记录慢查询和所有查询（只要没关 log_queries）
• 检查 config/database.php 对应连接的配置，必须有 'log_queries' => env('DB_LOG_QUERIES', false)，并在 .env 中设 DB_LOG_QUERIES=true
• 这个机制依赖 Monolog 的处理器链，不是简单 echo，所以日志格式统一、上下文完整，比手捞 getQueryLog() 更可靠

最易忽略的点：自定义 channel（比如 audit）的 level 是独立配置的，哪怕全局 LOG_LEVEL=debug，如果 'audit' => ['level' => 'info']，那 debug 级别日志照样不会进去。

今天关于《Laravel日志配置详解【追踪】》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！