如何让Google Stackdriver与Rails 7.1+兼容运行？

根本原因 #

Rails 7.1在ActiveSupport::Logger中新增了broadcast_to日志广播方法，但你使用的stackdriver 0.21.1版本过于老旧，其内置的Google::Cloud::Logging::Logger类并未实现这个新方法，导致启动时触发方法未定义错误。

解决方案 #

1. 升级stackdriver gem到兼容版本

旧版本0.21.1不支持Rails 7.1的新API，直接升级到最新稳定版即可解决：

• 修改Gemfile中的依赖：

  gem 'stackdriver', '~> 0.49.0' # 或更高兼容稳定版本
  

• 执行依赖更新：

  bundle update stackdriver
  

新版本的stackdriver gem已经适配了Rails 7.1的日志API，包含broadcast_to方法的实现。

2. 临时补丁方案（若升级遇到阻碍）

如果无法立即升级gem，可以通过初始化补丁手动添加兼容方法：

• 在config/initializers目录下创建google_logger_broadcast_patch.rb文件，写入以下代码：

  module Google
    module Cloud
      module Logging
        class Logger
          def broadcast_to(_target)
            # 兼容Rails 7.1的广播接口，返回自身以维持原有日志行为
            self
          end
        end
      end
    end
  end
  

• 重启Rails服务，错误即可消除。

3. 检查配置方式是否正确

确保你没有直接替换Rails默认Logger，而是通过中间件集成：
正确的配置示例（config/environments/development.rb）：

config.google_cloud.logging.project_id = "你的项目ID"
config.google_cloud.logging.keyfile = Rails.root.join("config/your-keyfile.json")
config.google_cloud.logging.log_name = "development_log"
# 通过中间件集成，而非直接替换config.logger
config.middleware.use Google::Cloud::Logging::Middleware

若直接设置config.logger = Google::Cloud::Logging::Logger.new(...)，会完全替换Rails的Logger实例，导致缺失Rails内置的日志扩展方法。

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