Rails 7.1升级后如何保留自定义Logger直接返回的原有行为？

方案1：直接覆盖Rails.logger为自定义实例 #

Rails 7.1默认会把配置的Logger包装成ActiveSupport::BroadcastLogger，你可以在初始化阶段直接替换掉这个包装实例，让Rails.logger回归自定义Logger：

在config/initializers/logger.rb中添加以下代码：

# 初始化你的自定义Logger（沿用原有项目的初始化逻辑）
CustomLogger = MyApp::Logger.new(Rails.root.join('log', "#{Rails.env}.log"))

# 替换Rails默认的BroadcastLogger为自定义实例
Rails.logger = CustomLogger

# 同步更新框架组件的Logger指向，避免日志分散
ActiveRecord::Base.logger = Rails.logger
ActionController::Base.logger = Rails.logger
ActionMailer::Base.logger = Rails.logger

这样所有原有Rails.logger.info('message', { arg_1: 'val' })格式的调用都能直接生效，无需修改业务代码。

方案2：让BroadcastLogger兼容自定义Logger的参数格式 #

如果需要保留BroadcastLogger的多日志广播能力，同时兼容原有带Hash参数的调用，可以通过方法转发实现：

在config/initializers/logger.rb中添加：

module CustomLoggerForwarder
  # 覆盖需要兼容的日志方法
  [:info, :warn, :error, :debug, :fatal].each do |method_name|
    define_method(method_name) do |message, payload = nil|
      # 检测到带Hash参数的调用时，转发到自定义Logger实例
      if payload.is_a?(Hash) && broadcasts.any?
        broadcasts.first.send(method_name, message, payload)
      else
        # 普通调用保留BroadcastLogger的原有广播逻辑
        super(message, payload)
      end
    end
  end
end

# 给BroadcastLogger注入转发逻辑
ActiveSupport::BroadcastLogger.prepend(CustomLoggerForwarder)

这种方式既保留了多Logger广播的特性，又无需修改原有业务代码中的日志调用。

方案3：提前配置Logger避免被包装 #

在config/application.rb中提前设置自定义Logger，跳过Rails自动包装为BroadcastLogger的逻辑：

module MyApp
  class Application < Rails::Application
    # 加载框架前先初始化自定义Logger
    config.logger = MyApp::Logger.new(Rails.root.join('log', "#{Rails.env}.log"))
    
    # 禁用默认的BroadcastLogger包装（部分Rails 7.1版本支持该配置）
    config.active_support.broadcast_logger = false
  end
end

注意：如果config.active_support.broadcast_logger配置不存在，仅设置config.logger即可，后续在初始化器中确认并补全组件Logger指向即可。

注意事项 #

• 测试所有环境（development/production/test）的日志输出，确保自定义Logger在各环境中正常工作
• 若项目中使用了依赖Logger的第三方Gem，需同步更新这些Gem的Logger指向为自定义实例

内容的提问来源于stack exchange，提问作者Gtchweb