Rails升级至Zeitwerk时RSpec测试命名规范冲突问题求助

我正在升级Rails框架，需要将自动加载器从classic切换为Zeitwerk。期间一直用bin/rails zeitwerk:check排查问题，现在遇到了spec文件相关的报错：user_spec.rb没有定义UserSpec常量，Zeitwerk校验不通过。

之前我通过添加词形变化规则解决过类似问题，比如：

Rails.autoloaders.each do |autoloader|
  autoloader.inflector.inflect(
    'aes' => 'AES',
  )
end

我的RSpec测试文件都是遵循标准规范写的，比如spec/models/user_spec.rb内容如下：

# spec/models/user_spec.rb

require 'rails_helper'

RSpec.describe User do
  # 测试代码
end

目前我想到三个不太理想的解决办法：

• 违背RSpec规范，把测试里的常量从User改成UserSpec；
• 在每个测试文件里定义空的UserSpec模块；
• 在application.rb里给每个测试文件单独加词形变化规则。

想请教有没有更合理的第四种方案？

你不需要修改任何测试文件或添加大量规则，核心问题是Zeitwerk不应该处理spec目录。

Rails默认配置下，Zeitwerk只会自动加载app/、lib/等应用代码目录，spec目录属于测试代码，本就不在自动加载路径中。如果你的项目里不小心把spec加到了自动加载路径，或者有自定义配置导致Zeitwerk扫描spec目录，只需要移除这个配置即可。

具体操作：

1. 检查config/application.rb或环境配置文件（比如config/environments/test.rb），确认有没有类似config.autoload_paths << Rails.root.join('spec')的代码，把它删掉；
2. 如果是通过Zeitwerk::Loader手动添加了spec目录，移除对应的loader.push_dir(Rails.root.join('spec'))代码；
3. 再次运行bin/rails zeitwerk:check，问题应该就解决了。

另外，如果你确实需要在测试中自动加载某些辅助代码，可以把它们放在spec/support/目录下，然后在rails_helper.rb里通过require_relative 'support/xxx'手动加载，或者配置RSpec自动加载support目录的文件，不需要让Zeitwerk处理这些。

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