预填充数据库键值与factory_bot create/build冲突问题

我太懂这种糟心的情况了——用db/seeds.rb预填充了像DocumentType这种用户不能修改的静态模型，结果用FactoryBot的create(:document_type)时，次次触发主键重复的报错，简直头疼！下面给你几个实用的解决思路：

思路1：让FactoryBot复用已有的静态数据（最推荐） #

既然这些数据是静态的，测试场景里根本不需要新建，直接复用seeds里的记录就好。修改你的FactoryBot定义，用find_or_create_by替代默认的创建逻辑：

FactoryBot.define do
  factory :document_type do
    # 用你seeds里用来标识唯一记录的字段（比如name）来匹配
    initialize_with { DocumentType.find_or_create_by(name: "身份证") }
  end
end

这样当你调用create(:document_type)时，FactoryBot会先检查数据库里有没有匹配的记录，有就直接返回，没有才创建，完美避开主键冲突。如果需要不同的静态类型，还可以给factory加trait：

FactoryBot.define do
  factory :document_type do
    initialize_with { DocumentType.find_or_create_by(name: "身份证") }

    trait :passport do
      initialize_with { DocumentType.find_or_create_by(name: "护照") }
    end
  end
end

用的时候就是create(:document_type, :passport)，直接复用对应的静态记录。

思路2：强制FactoryBot使用未被占用的主键（特殊场景用） #

如果你的测试确实需要创建新的DocumentType记录（虽然静态模型一般不建议这么做），可以让FactoryBot自动获取当前最大主键，然后递增：

FactoryBot.define do
  factory :document_type do
    id { DocumentType.maximum(:id).to_i + 1 }
    name { "测试文档类型_#{SecureRandom.uuid}" } # 确保name唯一，避免其他唯一约束报错
  end
end

注意：这个方法需要保证测试环境已经预加载了seeds数据，不然maximum(:id)会返回nil，to_i后变成0，加1就是1，还是会冲突。

思路3：优化Seeds.rb的写法，避免重复插入 #

先把你的seeds.rb改成幂等的（跑多次也不会重复创建记录），这样即使不小心重复执行seeds，也不会生成重复主键的记录：

# db/seeds.rb
DocumentType.find_or_create_by(id: 1) do |doc_type|
  doc_type.name = "身份证"
  doc_type.description = "居民身份证"
  # 其他字段赋值
end

DocumentType.find_or_create_by(id: 2) do |doc_type|
  doc_type.name = "护照"
  doc_type.description = "国际旅行护照"
end

配合思路1的FactoryBot写法，就能彻底解决主键冲突的问题。

额外小技巧 #

对于静态模型的测试，尽量用build_stubbed(:document_type)替代create——build_stubbed会生成一个内存中的模拟对象，不会操作数据库，既高效又不会触发任何数据库层面的约束冲突，非常适合不需要持久化的测试场景。

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