Rspec ValidateUniquenessOf匹配器执行失败问题排查

问题场景 #

我有一个包含name字段的ActiveRecord数据表，要求该字段非空且唯一：

• Rspec测试用例：

it { should validate_presence_of(:name) }
it { should validate_uniqueness_of(:name) }

• 模型验证规则：

validates :name, presence: true, uniqueness: true

• FactoryBot工厂定义：

FactoryBot.define do
  factory :model_name do
    sequence(:name) { |n| "Name #{n}" }

    after(:build) do |model|
      pack.rels << build(:relation)
    end
  end
end

运行测试时出现错误：

Failure/Error: it { should validate_uniqueness_of(:name) }
     
     Shoulda::Matchers::ActiveRecord::ValidateUniquenessOfMatcher::ExistingRecordInvalid:
       validate_uniqueness_of works by matching a new record against an
       existing record. If there is no existing record, it will create one
    Mysql2::Error: Field 'name' doesn't have a default value: INSERT INTO `table_name`

错误原因 #

1. 工厂钩子存在笔误：after(:build)钩子中使用了未定义的变量pack，正确的应该是传入的参数model。这个笔误会导致FactoryBot在构建对象时抛出异常，中断对象的正常创建流程。
2. Shoulda匹配器的依赖：validate_uniqueness_of匹配器需要先创建一条已存在的记录来测试唯一性，当工厂创建失败时，匹配器无法生成这条测试用记录，甚至会导致插入数据库时name字段未被赋值（因为工厂的sequence(:name)逻辑未正常执行），触发MySQL的非空约束错误。

修复方案 #

1. 修正工厂钩子的笔误 #

把钩子中的pack替换为model，确保关联操作正确指向当前构建的对象：

FactoryBot.define do
  factory :model_name do
    sequence(:name) { |n| "Name #{n}" }

    after(:build) do |model|
      model.rels << build(:relation)
    end
  end
end

2. 验证关联工厂的有效性 #

确保relation工厂能正常构建出合法的关联对象，否则添加关联的操作仍会失败，影响模型对象的创建。

3. 逐步排查（可选） #

如果问题仍存在，可以暂时注释掉after(:build)钩子，先测试唯一性验证是否正常运行，确认基础逻辑没问题后，再逐步调试关联部分的代码。

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