Rails自定义测试Rake任务报错：uninitialized constant Shoulda

问题原因 #

Rails 7 对测试任务的初始化流程做了调整：

• 官方rails test或rake test命令会自动触发完整的测试环境初始化，包括激活test组的所有gem、加载test/test_helper.rb的上下文。
• 你之前直接调用Rails::TestUnit::Runner.run的方式，跳过了这些关键初始化步骤，导致shoulda-matchers这类测试依赖未被加载，从而触发NameError。

解决方法 #

方法1：使用官方rails test命令执行子集测试（最简单）

修改Rake任务，通过系统命令调用官方测试命令，让Rails自动处理环境初始化：

# lib/tasks/carrier.rake
namespace :test do
  task carriers: "test:prepare" do
    test_files = FileList[
      "test/models/carrier_test.rb",
      "test/controllers/admin/carriers/**/*_test.rb",
      "test/system/admin/carriers/**/*_test.rb"
    ]
    exec "rails test #{test_files.shelljoin}"
  end
end

shelljoin能自动处理文件名中的特殊字符，比直接join(' ')更安全。

方法2：手动补全测试环境初始化

在自定义任务中手动激活测试组gem并加载test_helper.rb：

# lib/tasks/carrier.rake
namespace :test do
  task carriers: "test:prepare" do
    # 激活test组的所有gem
    Bundler.require(:test)
    # 加载测试助手文件
    require_relative "../../test/test_helper"
    $: << "test"
    
    test_files = FileList[
      "test/models/carrier_test.rb",
      "test/controllers/admin/carriers/**/*_test.rb",
      "test/system/admin/carriers/**/*_test.rb"
    ]
    Rails::TestUnit::Runner.run(test_files)
  end
end

方法3：使用Rails官方Rails::TestTaskAPI（推荐）

Rails提供了专门的Rails::TestTask类来定义自定义测试任务，它会自动处理环境初始化、依赖加载等流程，兼容性最好：

# lib/tasks/carrier.rake
namespace :test do
  Rails::TestTask.new(:carriers => "test:prepare") do |t|
    t.test_files = FileList[
      "test/models/carrier_test.rb",
      "test/controllers/admin/carriers/**/*_test.rb",
      "test/system/admin/carriers/**/*_test.rb"
    ]
  end
end

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