Rails 7 Engine运行rspec时触发FrozenError问题求助

问题概述 #

将Rails Engine从Rails 5升级到Rails 7后，运行RSpec测试时触发FrozenError: can't modify frozen Array错误，该问题从Rails 6.1.7.6版本开始出现，升级到Rails 7后仍未解决：

• 错误触发点：Rails.application.initialize!执行时，Rails源码railties-7.0.7.2/lib/rails/engine.rb第575行的unshift操作尝试修改已冻结的数组
• 触发流程：测试文件加载spec_helper.rb → dummy/config/environment.rb后触发错误
• 调试发现：:set_autoload_paths初始化器被重复调用34次，调用方包含Rails内置引擎及gemspec引入的第三方库引擎

原因分析 #

1. Rails从6.1版本开始强化了自动加载路径的冻结机制，防止运行时意外修改核心配置数组
2. 当多个引擎（内置、第三方、自定义引擎）重复执行:set_autoload_paths初始化器时，后续的数组修改操作（如unshift）会尝试修改已被冻结的autoload_paths数组，从而抛出错误
3. 重复调用的根源通常是spec环境下的引擎初始化逻辑冗余，或第三方引擎未适配Rails 6.1+的冻结机制

解决方案 #

1. 修复spec环境的重复初始化问题 #

检查spec_helper.rb中的加载逻辑，确保Rails应用只初始化一次：

# spec/spec_helper.rb
unless defined?(Rails.application)
  require File.expand_path("../dummy/config/environment", __FILE__)
end

• 避免重复调用require加载dummy环境文件，改用条件判断确保只初始化一次
• 排查是否存在多次调用自定义引擎初始化方法（如MyEngine::Engine.initialize!）的代码

2. 排查并修复第三方引擎冲突 #

• 临时移除gemspec中的第三方引擎，确认错误是否消失，定位到具体冲突的依赖
• 升级冲突的第三方引擎到适配Rails 7的最新版本，查看其是否修复了自动加载路径的冻结处理逻辑
• 若第三方引擎有自定义的set_autoload_paths逻辑，检查其是否遗漏了数组冻结状态的判断

3. 临时绕过冻结机制（仅作应急方案） #

优先推荐前两种方案，若需临时修复，可在dummy应用的config/application.rb中添加：

# dummy/config/application.rb
config.before_initialize do
  ActiveSupport::Dependencies.autoload_paths.unfreeze if ActiveSupport::Dependencies.autoload_paths.frozen?
end

config.after_initialize do
  ActiveSupport::Dependencies.autoload_paths.freeze
end

或在自定义引擎的engine.rb中调整初始化时机：

# lib/my_engine/engine.rb
initializer :unfreeze_autoload_paths_before_set, before: :set_autoload_paths do
  ActiveSupport::Dependencies.autoload_paths.unfreeze if ActiveSupport::Dependencies.autoload_paths.frozen?
end

4. 调整引擎初始化顺序 #

在自定义引擎中明确初始化器的执行顺序，避免与内置/第三方引擎冲突：

# lib/my_engine/engine.rb
initializer :custom_autoload_paths, after: :set_autoload_paths do
  # 自定义自动加载路径逻辑，此时数组已完成初始化且未被重复修改
end

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