Rails：带作用域的唯一性验证在更新对象时失效的调试

这个问题我之前在开发Rails应用时也碰到过，咱们一步步来排查原因并解决：

1. 检查验证是否被限制仅在创建时运行 #

首先看你的验证代码有没有加on: :create选项：

# 错误示例：仅在创建时验证
validates :match_id, uniqueness: { scope: [:participant_id], on: :create }

如果加了这个选项，验证只会在create动作时触发，更新时会被跳过。解决办法就是去掉on: :create，Rails默认会在create和update时都执行该验证：

# 正确写法：创建和更新都验证
validates :match_id, uniqueness: { scope: [:participant_id] }

2. 确认更新操作没有跳过验证 #

Rails里有些方法会直接跳过验证逻辑，比如update_attribute、update_columns、save(validate: false)。如果你在更新时用了这些方法，唯一性验证根本不会被执行。

比如下面的代码就会跳过验证：

# 跳过验证的更新方式，会导致唯一性校验失效
@prediction.update_columns(match_id: new_match_id)
@prediction.update_attribute(:match_id, new_match_id)
@prediction.save(validate: false)

要改成触发验证的更新方法：

# 正确的更新方式，会执行所有验证
@prediction.update(match_id: new_match_id)
# 或者
@prediction.match_id = new_match_id
@prediction.save

3. 排查软删除导致的验证异常 #

如果你的Prediction模型使用了软删除（比如acts_as_paranoid或discard gem），默认的唯一性验证会包含被软删除的记录。这时候如果同一个participant_id和match_id组合有一条已删除的记录，可能会出现不符合预期的验证结果。

你可以通过conditions选项自定义验证的查询范围，排除软删除的记录：

validates :match_id, uniqueness: { 
  scope: [:participant_id], 
  conditions: -> { where(deleted_at: nil) } # 排除已软删除的记录
}

4. 务必添加数据库层面的唯一索引 #

应用层的唯一性验证存在并发漏洞（比如两个请求同时通过验证，插入重复记录），所以即使解决了更新时的验证问题，也要给数据库添加唯一索引来兜底。

生成迁移文件：

rails generate migration AddUniqueIndexToPredictionsParticipantIdAndMatchId

然后在迁移文件里添加：

class AddUniqueIndexToPredictionsParticipantIdAndMatchId < ActiveRecord::Migration[7.0]
  def change
    add_index :predictions, [:participant_id, :match_id], unique: true
  end
end

执行迁移：

rails db:migrate

控制台测试验证逻辑 #

你可以在Rails控制台里手动测试验证是否正常工作，快速定位问题：

# 获取测试用的Participant和Match
participant = Participant.first
match1 = Match.first
match2 = Match.second

# 创建第一个Prediction，成功
pred1 = Prediction.create!(participant: participant, match: match1)
# 创建第二个Prediction，成功
pred2 = Prediction.create!(participant: participant, match: match2)

# 尝试把pred2的match_id改成match1的id，应该触发验证失败
pred2.update(match_id: match1.id)
# 检查错误信息
pred2.errors.full_messages # 应该包含"Match has already been taken"

如果控制台测试时验证正常，但实际代码里失效，那大概率是代码里用了跳过验证的更新方法或者验证被限制了执行时机。

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