解决Rails中ActiveSupport::LoggerThreadSafeLevel::Logger未初始化错误

问题描述

当在 Rails 6.1（Ruby 2.6.x）环境中执行 bundle update 升级到特定版本（如 activesupport-6.1.7.10）后，启动应用时可能会遇到以下致命错误：

uninitialized constant ActiveSupport::LoggerThreadSafeLevel::Logger (NameError)

错误栈追踪显示问题源于 ActiveSupport 的线程安全日志级别模块：

active_support/logger_thread_safe_level.rb:16:in `module:LoggerThreadSafeLevel'

典型触发场景：

• Rails 应用启动时崩溃，但 Rails Console 可正常使用
• 发生在 bundle update 更新某些 gem 后
• 影响 Rails 6.x 及 7.0 版本，与 concurrent-ruby gem 的版本更新直接相关

错误根源

此问题的根本原因是 concurrent-ruby gem 1.3.5 版本移除了对 Ruby 标准库 logger 的依赖：

1. Rails 6.1 依赖 concurrent-ruby 处理线程安全
2. concurrent-ruby v1.3.5 移除了 require 'logger'
3. Rails 6.1 的 ActiveSupport 模块内部依赖 Logger 常量
4. 当 concurrent-ruby 不再引入 logger 时，导致 Rails 启动时找不到 Logger 常量

官方 Issue 跟踪 已确认此兼容性问题。

解决方案

✅ 方案1：锁定 concurrent-ruby 版本（推荐）

在 Gemfile 中明确指定使用 1.3.4 版本：

gem 'concurrent-ruby', '1.3.4'

然后执行更新：

bundle update concurrent-ruby

优点：简单直接，无需修改应用代码
缺点：需等待 Rails 官方后续兼容更新

✅ 方案2：手动引入 logger 依赖（无版本锁定）

在 config/boot.rb 的开头添加 logger 引入：

ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __dir__)

require 'bundler/setup'
require 'logger' # 手动引入标准库logger
require 'bootsnap/setup' # 如果使用了bootsnap

作用说明

此操作确保在 Rails 加载前初始化 Ruby 的 Logger 常量，解决 ActiveSupport 的依赖缺失问题。

🔧 备选方案

若上述方法无效（如未使用 bootsnap），可在 config/application.rb 首部添加：

require 'logger' # 确保在第一行
require_relative 'boot'
# ...后续代码

注意事项

• 避免直接修改 Gem 源码（如 active_support 文件），这会导致维护困难
• 升级至 Rails 7.1+ 可彻底解决，但需评估项目升级成本
• 方案2是 Rails 核心团队 推荐的修复方式

验证步骤

1. 修改配置后重启 Rails 服务
2. 检查日志确认无报错
3. 在 Rails console 中验证常量加载：

ActiveSupport::LoggerThreadSafeLevel.const_defined?(:Logger) # 应返回 true

总结建议

场景	推荐方案	操作难度
短期修复	方案1（锁定版本）	⭐
长期维护	方案2（引入logger）	⭐⭐
新项目	升级至 Rails 7.1+	⭐⭐⭐

所有解决方案均在 Ruby 2.6+ 和 Rails 6.1+ 环境验证通过。建议优先采用方案2，既保持 concurrent-ruby 更新能力，又规避兼容性问题。此问题已在新版 Rails 7.1 中修复，长期项目可规划升级路线。