Rails 6.1升级后Job spec错误被Minitest::UnexpectedError包裹如何修复

问题根因 #

Rails 6.1 版本调整了ActiveJob测试辅助方法的默认异常处理逻辑：使用perform_enqueued_jobs执行排队任务时，测试队列适配器默认会捕获任务抛出的原始业务异常，将其包装为Minitest::UnexpectedError后再抛出，导致原有直接匹配自定义异常类型的raise_error断言无法命中。

可选修复方案 #

• 方案1：单用例关闭异常包装（推荐）
  给perform_enqueued_jobs方法传入catch_errors: false参数，关闭单场景下的异常捕获包装逻辑，原始异常会直接透传，原有断言逻辑无需修改：

  describe MyJob, type: :job do
    it "throws an error" do
      expect do
        perform_enqueued_jobs(catch_errors: false) { MyJob.perform_later }
      end.to raise_error(described_class::MyError)
    end
  end
  

• 方案2：全局关闭测试环境异常包装
  如果项目中绝大多数Job测试都需要直接断言原始异常，可以在RSpec全局配置中统一设置测试适配器不捕获异常，配置位置通常为spec/rails_helper.rb：

  RSpec.configure do |config|
    config.before(:each, type: :job) do
      queue_adapter = ActiveJob::Base.queue_adapter
      queue_adapter.catch_errors = false if queue_adapter.respond_to?(:catch_errors=)
    end
  end
  

  注意：如果需要测试任务重试、异常上报（如Airbrake、Sentry集成）等依赖Job自身异常捕获流程的场景，不要使用全局关闭配置，避免影响这类场景的测试逻辑。

• 方案3：匹配包装异常的原始异常
  保留默认异常包装逻辑的前提下，可以通过异常的cause属性匹配内部包裹的原始自定义异常：

  describe MyJob, type: :job do
    it "throws an error" do
      expect do
        perform_enqueued_jobs { MyJob.perform_later }
      end.to raise_error { |wrapper_err|
        expect(wrapper_err.cause).to be_a(described_class::MyError)
      }
    end
  end
  

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