RSpec单测通过批量运行失败，求排查测试用例冲突问题

问题背景 #

单个测试用例运行时可通过，但所有测试一起运行时失败。使用--bisect参数得到最小复现命令：

The minimal reproduction command is:
  rspec ./spec/requests/api/v1/categories_requests_spec.rb[1:3:1] ./spec/requests/api/v1/categorizations_requests_spec.rb[1:1:1]

对应测试代码 #

删除分类测试（categories_requests_spec.rb[1:3:1]） #

describe 'DELETE api/v1/categories/:id' do
    let!(:category) { create :category }
    let(:params) { { id: category.id } }

    subject { delete api_v1_category_path(params) }

    it 'delete category' do
      expect { subject }.to change { Category.count }.by(-1)
      expect(response).to have_http_status(200)
    end
  end

创建分类关联测试（categorizations_requests_spec.rb[1:1:1]） #

RSpec.describe 'Api::V1::Categorizations', type: :request do
  let(:category) { create :category }
  let(:product) { create :product }

  describe 'POST api/v1/categorizations' do
    let(:params) { { category_id: category.id, product_id: product.id } }
    subject { post api_v1_categorizations_path, params: params }

    it 'create categorization' do
      expect { subject }.to change { Categorization.count }.by(1)
      expect(response).to have_http_status(201)
    end

    context 'does not create a new categorization if it already exists' do
      let!(:categorization) do
        create :categorization, category: category, product: product
      end

      it 'does not create categorization' do
        expect { subject }.not_to(change { Categorization.count })
        expect(response).to have_http_status(422)
      end
    end
  end

报错信息 #

Failures:

  1) Api::V1::Categorizations POST api/v1/categorizations create categorization
     Failure/Error: expect { subject }.to change { Categorization.count }.by(1)
       expected `Categorization.count` to have changed by 1, but was changed by 0
     # ./spec/requests/api/v1/categorizations_requests_spec.rb[1:15:in `block (3 levels) in <main>'
     # ./spec/spec_helper.rb:100:in `block (3 levels) in <top (required)>'
     # ./spec/spec_helper.rb:99:in `block (2 levels) in <top (required)>'

排查分析 #

核心问题出在测试间的数据库状态未正确隔离，具体可能的原因包括：

• Database Cleaner配置错误：Request测试会启动真实HTTP服务器，默认的transaction清理策略无法跨线程生效，导致前一个测试的数据库残留数据影响后续测试。
• 模型关联的副作用：虽然两个测试的Category ID不同，但如果Categorization与Category的关联配置了dependent选项，前一个测试删除Category时可能触发了未预期的数据库操作，干扰了后续测试的状态。
• FactoryBot序列未重置：如果Category/Product工厂使用了序列字段（如name），测试间未重置序列可能导致数据重复，触发Categorization的唯一索引约束（[category_id, product_id]）。
• 控制器事务未提交：第一个测试的删除请求可能因事务未正确提交，导致数据库状态未及时更新，间接影响后续测试。

解决建议 #

1. 修正Database Cleaner配置：为Request测试单独设置truncation清理策略，确保测试间数据库完全重置：

   config.before(:suite) do
     DatabaseCleaner.strategy = :transaction
     DatabaseCleaner.clean_with(:truncation)
   end
   
   config.before(:each) do
     if example.metadata[:type] == :request
       DatabaseCleaner.strategy = :truncation
     else
       DatabaseCleaner.strategy = :transaction
     end
     DatabaseCleaner.start
   end
   
   config.after(:each) do
     DatabaseCleaner.clean
   end
   

2. 查看请求返回详情：在失败测试中添加puts response.body，确认具体的创建失败原因（如验证错误、约束冲突）。
3. 重置FactoryBot序列：在spec_helper.rb中添加config.before(:each) { FactoryBot.reload }，确保每个测试使用全新的序列值。
4. 验证模型关联配置：检查Categorization模型的关联规则，确认dependent选项未产生未预期的副作用。

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