Rails中first_or_initialize后update报唯一性校验失败的解决方法

update入参里重复传入deal_id不是触发这个错误的原因，Rails更新时会自动对比属性值，传入和对象当前值完全一致的属性不会触发额外校验逻辑。

报错核心原因 #

这个错误是模型层validates :deal_id, uniqueness: true校验触发的，本质是你执行first_or_initialize的查询逻辑，和唯一性校验的查询逻辑不对齐，或者存在并发竞态，常见场景有两类：

• 存在过滤条件不一致的问题
  这是最高发的场景：如果你的Booking模型带了默认作用域（比如软删除default_scope { where(deleted_at: nil) }、多租户数据隔离默认加了account_id过滤），first_or_initialize查询时会自动带上这些过滤条件，找不到已软删除/属于其他租户的同deal_id记录，就会初始化新对象；但如果你写唯一性校验时没有加匹配的过滤条件，校验执行的数据库查询缺少对应过滤规则，就会查到那些本应被过滤的重复记录，直接触发报错。
• 并发请求导致的竞态条件
  两个请求同时执行到first_or_initialize时，都没有查到对应deal_id的记录，都会初始化新的Booking对象。其中一个请求先执行update成功写入数据库后，另一个请求再跑唯一性校验就会查到刚写入的重复记录，触发报错。

另外还有个低概率场景：params["id"]为nil时，如果你的库表中已经存在deal_id为NULL的记录，且唯一性校验没有配置allow_nil: true，也会触发这个错误。

修复方案 #

1. 对齐查询、校验、数据库索引的逻辑
   确保唯一性校验的查询条件和你first_or_initialize的查询条件完全一致，如果有软删除、多租户类的过滤规则，要同步写到校验里，同时给数据库加匹配的唯一索引（模型校验无法100%阻止并发重复，必须靠数据库层索引兜底）：

   # app/models/booking.rb
   # 以软删除场景为例，校验要带上和查询一致的过滤条件
   validates :deal_id, uniqueness: { conditions: -> { where(deleted_at: nil) } }
   

   # 数据库迁移文件，加和校验匹配的部分唯一索引
   add_index :bookings, :deal_id, unique: true, where: "deleted_at IS NULL"
   

   如果是多租户场景，给校验加scope: :account_id，索引也同时加入account_id字段即可。

2. 移除update!中冗余的deal_id传参
   虽然冗余传参不是报错原因，但first_or_initialize已经给对象赋值了正确的deal_id，重复传参没有意义，还可能出现参数值类型不匹配、意外传错值的问题，简化后的代码：

   booking = Booking.where(deal_id: params["id"]).first_or_initialize
   if booking.update!(names: "some names")
     # 你的其他业务逻辑
   end
   

3. 兜底处理并发异常
   在更新逻辑外层捕获数据库层抛出的ActiveRecord::RecordNotUnique异常，做重试或者友好的错误提示，覆盖极端并发下的重复场景。

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