运行Rails测试用例时触发ActiveRecord::RecordNotUnique错误排查

报错原因 #

• 隐式重复创建用户：虽然你的测试仅验证Category实例有效性，但引入Devise::Test::ControllerHelpers后，测试流程可能通过sign_in方法、测试前置回调，或是Category关联逻辑（比如创建Category时自动关联用户），重复插入了相同邮箱的用户记录，触发users.email字段的唯一约束。
• 测试数据未清理：测试运行时没有重置数据库或清理用户表数据，之前测试生成的用户记录残留，导致后续测试再次创建同邮箱用户时冲突。
• 硬编码测试用户：如果测试中使用了固定邮箱的硬编码用户（比如sign_in User.create!(email: 'test@example.com', ...)），每次测试运行都会尝试创建该用户，重复执行就会触发唯一约束错误。

解决办法 #

• 添加数据清理逻辑：在测试的setup或teardown阶段清理用户表，比如在测试文件开头添加：

  setup do
    User.destroy_all
  end
  

  或者使用DatabaseCleaner gem统一管理测试数据清理。
• 使用唯一序列生成测试用户邮箱：如果用FactoryBot创建用户，给邮箱字段添加序列确保唯一性：

  factory :user do
    sequence(:email) { |n| "test_user_#{n}@example.com" }
    password { 'password123' }
  end
  

• 避免重复创建用户：使用find_or_create_by确保同一邮箱只创建一次：

  user = User.find_or_create_by(email: 'test@example.com') do |u|
    u.password = 'password123'
  end
  sign_in user
  

• 检查关联逻辑：确认Category模型是否有自动创建用户的回调（比如before_save），如果有，在测试中手动控制用户创建流程，避免重复触发。

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