SolidQueue日志配置：开发环境最佳实践

SolidQueue作为Rails生态中的异步任务处理工具，其日志配置在开发环境中常常让开发者感到困惑。本文将深入分析SolidQueue的日志机制，并提供实用的配置建议。

默认日志行为解析

SolidQueue默认使用Rails的日志系统，这意味着：

1. 在开发环境中，日志默认写入log/development.log文件
2. 与控制台应用不同，bin/jobs进程不会自动输出到STDOUT
3. 当通过Puma插件运行时，日志会共享Web进程的日志配置

这种设计源于SolidQueue主要面向生产环境的定位，开发环境推荐使用async适配器。

开发环境日志配置方案

方案一：全局STDOUT日志

在config/environments/development.rb中添加：

# Rails 8+
config.logger = ActiveSupport::TaggedLogging.logger(STDOUT)

# Rails 7.x及以下
config.logger = ActiveSupport::Logger.new(STDOUT)
  .then { |logger| ActiveSupport::TaggedLogging.new(logger) }

此配置将使所有Rails组件（包括SolidQueue）的日志都输出到控制台。

方案二：双日志输出

使用Rails 7.1+的BroadcastLogger同时输出到文件和控制台：

file_logger = ActiveSupport::Logger.new("log/development.log")
console_logger = ActiveSupport::Logger.new(STDOUT)
config.logger = ActiveSupport::BroadcastLogger.new(file_logger, console_logger)

方案三：独立配置SolidQueue日志

在bin/jobs文件中显式设置：

SolidQueue.logger = ActiveSupport::Logger.new($stdout)

注意：此方式仅影响SolidQueue自身的日志，ActiveRecord查询日志仍会写入默认位置。

进程管理工具集成

使用Foreman或Overmind等工具时，推荐采用全局STDOUT日志方案，这样可以在统一界面查看所有进程日志。典型Procfile配置：

web: bin/rails s
jobs: bin/jobs

生产环境注意事项

生产环境中，SolidQueue的日志行为与Rails应用一致，通常建议：

1. 使用日志轮转功能
2. 考虑结构化日志格式
3. 设置适当的日志级别
4. 监控日志文件大小

通过合理配置日志系统，可以更好地监控SolidQueue的工作状态，及时发现和处理任务处理中的问题。