如何配置Rails与RSpec以支持模型子目录的自动加载？

• 目录结构：app/models/foos/bar.rb
• 在application.rb中配置的自动加载路径：

  module AppName
    class Application < Rails::Application
      config.load_defaults 7.0
  
      config.public_file_server.enabled = true
  
      config.autoload_paths += Dir[Rails.root.join('app', 'models', '**/')]
    end
  end
  

• 开发环境（development.rb）配置：

  config.cache_classes = false
  config.eager_load = false
  

• 测试环境（test.rb）配置：

  config.cache_classes = false
  config.eager_load = false
  

• 测试文件spec/models/bar_spec.rb内容：

  describe Bar do
    # ...测试代码
  end
  

• 执行rspec时抛出错误：NameError: uninitialized constant Bar，该问题仅出现在测试环境，开发环境正常。

1. 遵循Rails自动加载约定（推荐） #

Rails 7默认使用Zeitwerk自动加载器，要求目录对应命名空间、文件名对应类名：

• 修改app/models/foos/bar.rb中的类定义，添加命名空间：

  class Foos::Bar < ApplicationRecord
    # ...类代码
  end
  

• 同步修改测试文件spec/models/bar_spec.rb：

  describe Foos::Bar do
    # ...测试代码
  end
  

这种方式无需额外配置自动加载路径，完全符合Rails规范，能在所有环境稳定生效。

2. 显式配置测试环境的自动加载路径 #

如果坚持不使用命名空间，需在test.rb中重复添加自动加载路径配置：

config.autoload_paths += Dir[Rails.root.join('app', 'models', '**/')]

同时确保app/models/foos/bar.rb中的类是顶级Bar：

class Bar < ApplicationRecord
  # ...类代码
end

3. 调整测试环境的自动加载模式 #

若使用Zeitwerk模式出现适配问题，可在test.rb中切换为经典自动加载模式：

config.autoload_mode = :classic

4. 清除测试环境缓存 #

缓存可能导致加载异常，执行命令清除缓存后重新测试：

rails tmp:clear RAILS_ENV=test

5. 检查RSpec配置 #

• 确保测试文件开头引入rails_helper.rb而非仅spec_helper.rb：

  require 'rails_helper'
  

• 检查spec/rails_helper.rb中是否有禁用Rails自动加载的配置，若有可调整或注释。

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