Rails中SQLite3唯一性约束验证失败问题求助

咱们先定位问题核心：这个错误说明数据库层面的唯一约束被触发，但模型层的验证没拦住请求。下面咱们一步步排查和解决：

1. 先确保测试数据库是干净的 #

Rails默认在测试环境下，每个测试用例会用事务包裹，测试结束后自动回滚数据，不会留下残留。但如果配置被修改过，就可能出现数据堆积：

• 打开test/test_helper.rb，检查是否有config.use_transactional_fixtures = false，如果有改成true；
• 运行rails db:migrate RAILS_ENV=test，确保测试数据库的结构和开发环境完全同步；
• 如果还是有问题，手动清空测试数据库：rails db:reset RAILS_ENV=test（注意：这会删除测试库所有数据）。

2. 检查迁移文件的执行顺序 #

你的两个迁移文件，CreateProducts必须在AddIndexToProduct之前执行（得先有表才能加索引）。Rails是靠文件名的时间戳前缀排序执行的，所以要确认：

• CreateProducts的文件名时间戳更早（比如20240101000000_create_products.rb在前，20240101000001_add_index_to_product.rb在后）；
• 如果顺序反了，回滚迁移后重新执行：

  rails db:rollback STEP=2
  rails db:migrate
  

3. 修复模型验证的冗余问题（避免额外坑） #

你给price写了两次presence: true，合并成一个更简洁：

validates :name, presence: true, length: {maximum: 15}, uniqueness: {case_sensitive: false}
validates :price, presence: true, length: {maximum: 15}, numericality: {only_float: true, greater_than: 0, less_than: 10000}
validates :inventory, presence: true, numericality: {only_integer: true, greater_than: 0, less_than: 10000}

4. 解决SQLite索引大小写敏感的潜在问题 #

SQLite默认的唯一索引是区分大小写的，但你的模型验证是case_sensitive: false，这会导致：如果模型验证失效（比如并发场景），数据库仍会允许大小写不同的同名数据。修改迁移文件让索引忽略大小写：

class AddIndexToProduct < ActiveRecord::Migration[5.1]
  def change
    add_index :products, 'name COLLATE NOCASE', unique: true
  end
end

然后重新同步测试库结构：rails db:migrate RAILS_ENV=test

5. 排查具体测试用例的数据残留 #

如果products should be unique测试仍报错，大概率是测试库已有同名数据。可以在测试里加debug代码排查：

test "products should be unique" do
  # 先清空所有商品，确保测试环境干净
  Product.destroy_all
  duplicate_product = @product.dup
  duplicate_product.name = @product.name.upcase
  @product.save
  puts "Existing products: #{Product.pluck(:name)}" # 打印现有商品名称，方便排查
  assert_not duplicate_product.valid?
end

运行这个测试，看输出的商品列表是否有重复数据。

最后验证 #

执行完以上步骤后，重新运行测试：

rails test

应该就能解决唯一约束报错的问题了。

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