Rails Minitest中PG::UniqueViolation错误排查求助

看起来你踩了两个常见的测试坑：重复创建触发唯一约束和测试数据清理不彻底，而且核心误解是「测试环境不会触发Active Record回调」——其实回调是模型层逻辑，不管运行环境，只要创建Item，after_create就会执行。下面给你几个不用修改业务逻辑的解决方案：

你的问题本质是「Item创建时自动生成Blob，你又手动创建了同(user_id, item_id)的Blob」，二选一即可，推荐以下两种方式：

方案1：复用回调生成的Blob，不再手动创建 #

既然业务逻辑已经会自动生成Blob，测试里直接复用这条即可，需要修改属性的话再更新：

def setup
  DatabaseCleaner.start
  # 创建用户
  @user1 = FactoryBot.create(:user, email: "a@pear.com", username: "barnyard")
  @user2 = FactoryBot.create(:user, email: "bo@ichi.com", username: "ponygrl")
  @user3 = FactoryBot.create(:user, email: "ho@ho.com", username: "hon")
  # 创建Item（此时after_create已经生成对应的Blob）
  @item1 = FactoryBot.create(:item, owner: @user1)
  @item2 = FactoryBot.create(:item, owner: @user2, price: 101)
  @item3 = FactoryBot.create(:item, owner: @user3, price: 102)
  # 复用自动生成的Blob，修改需要的属性（比如active: false）
  @blob1 = @item1.blobs.first # 先确保Item和Blob建立了关联
  @blob1.update!(active: false)
  @blob2 = @item2.blobs.first
  @blob2.update!(active: false)
  @blob3 = @item3.blobs.first
  @blob3.update!(active: false)
end

注意：给Item模型补充关联，让查询更方便（这是模型完善，不属于修改业务逻辑）：

class Item < ApplicationRecord
  belongs_to :owner, class_name: 'User'
  has_one :blob, dependent: :destroy # 新增这条关联
  after_create :create_blobs

  private
  def create_blobs
    blob = Blob.new(user_id: self.owner.id, item_id: self.id, amount: self.price)
    blob.save
  end
end

方案2：测试中临时禁用回调（仅在需要手动创建Blob时） #

如果你的测试确实需要完全自定义Blob（比如和业务逻辑生成的不一样），可以在测试setup里临时禁用回调，测试结束后恢复：

def setup
  DatabaseCleaner.start
  # 临时禁用Item的after_create回调
  Item.skip_callback(:create, :after, :create_blobs)
  # 后续创建用户、Item、Blob的代码保持不变
  @user1 = FactoryBot.create(:user, email: "a@pear.com", username: "barnyard")
  # ... 其他原有代码
end

def teardown
  # 恢复回调，避免影响其他测试
  Item.set_callback(:create, :after, :create_blobs)
  DatabaseCleaner.clean
end

这个方案适合脱离业务逻辑自定义Blob的测试场景，一定要在teardown里恢复回调，否则其他测试会出问题。

这个问题大概率是测试数据清理不彻底或者FactoryBot生成重复数据导致的，解决如下：

1. 优化FactoryBot生成唯一数据 #

你的User工厂默认使用固定的email和username，如果其他测试没指定唯一值，就会和当前测试冲突。改成自动生成唯一值：

FactoryBot.define do
  factory :user, aliases: [:owner] do
    # 用sequence生成唯一的邮箱和用户名
    sequence(:email) { |n| "test_user_#{n}@example.com" }
    sequence(:username) { |n| "test_user_#{n}" }
  end
  # 其他工厂保持不变
end

这样不管在哪里创建User，都会自动生成唯一的邮箱和用户名，彻底避免手动指定遗漏的问题。

2. 确保DatabaseCleaner配置正确 #

检查你的test/support/database_cleaner.rb配置，确保它能正确隔离测试数据：

# test/support/database_cleaner.rb
require 'database_cleaner'

DatabaseCleaner.strategy = :transaction

class Minitest::Test
  def setup
    DatabaseCleaner.start
  end

  def teardown
    DatabaseCleaner.clean
  end
end

• 单元测试用:transaction策略足够快，能保证测试之间的数据隔离。
• 如果有Capybara等需要访问真实数据库的集成测试，需要把策略改成:truncation（或者分环境配置）。
• 确保test/test_helper.rb里已经添加了require 'support/database_cleaner'，让所有测试类都能加载这个配置。

• 永远不要假设「测试环境不会触发回调」——Active Record回调是模型层逻辑，和运行环境无关，除非你显式禁用。
• 尽量复用业务逻辑生成的数据，这样测试更贴近真实场景，也能避免重复创建的问题。
• 如果还是遇到数据隔离问题，检查是否有测试手动提交了事务（比如调用了commit方法），这会破坏DatabaseCleaner的事务隔离。

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