Gorm Update忽略Limit子句，软删除场景下如何安全更新指定数量数据？

问题背景 #

Gorm的Update语句不会识别Limit子句，直接使用会导致全量更新符合Where条件的记录；将Limit嵌入Where子句的方案，在软删除场景下会因Gorm自动追加AND deleted_at IS NULL而失效；先查询后更新的两步操作存在并发冲突风险。

解决方案 #

针对PostgreSQL，我们可以利用数据库原生的FOR UPDATE SKIP LOCKED特性，结合Gorm实现原子性的选更操作，彻底避免冲突。

方案1：原生SQL直接执行

通过Gorm的Raw方法执行原生PostgreSQL更新语句，显式处理软删除过滤，并利用子查询锁定目标记录：

var updatedVoucherIDs []uint
err := tx.Raw(`
    UPDATE vouchers 
    SET status = ? 
    WHERE id IN (
        SELECT id 
        FROM vouchers 
        WHERE status = ? AND deleted_at IS NULL 
        LIMIT ? 
        FOR UPDATE SKIP LOCKED
    )
    RETURNING id
`, models.VoucherStatusBooked, models.VoucherStatusAvailable, quantity).Scan(&updatedVoucherIDs).Error

if err != nil {
    // 处理更新错误
}

• 子查询通过FOR UPDATE SKIP LOCKED锁定指定数量的可用且未软删除的券，跳过已被其他事务锁定的记录，避免竞态冲突
• 外层语句更新锁定记录的状态，RETURNING id可获取更新后的记录ID，方便后续业务逻辑处理

方案2：Gorm链式调用结合锁定子句

利用Gorm的Clauses方法添加锁定逻辑，自动适配软删除过滤：

// 构建子查询：锁定指定数量的可用券
subQuery := tx.Model(&daos.Voucher{}).
    Where("status = ?", models.VoucherStatusAvailable).
    Limit(quantity).
    Clauses(clause.Locking{
        Strength: "UPDATE",
        Options:  "SKIP LOCKED",
    }).
    Select("id")

// 执行更新操作
resUpdate := tx.Model(&daos.Voucher{}).
    Where("id IN (?)", subQuery).
    Update("status", models.VoucherStatusBooked)

if resUpdate.Error != nil {
    // 处理更新错误
}

• Gorm会自动为带软删除标签的daos.Voucher结构体添加deleted_at IS NULL过滤条件，无需手动编写
• Clauses(clause.Locking{})等价于在子查询中添加FOR UPDATE SKIP LOCKED，保证原子性和冲突避免

注意事项 #

• SKIP LOCKED是PostgreSQL 9.5及以上版本支持的特性，请确认数据库版本符合要求
• 若业务要求必须更新指定数量的记录（不跳过锁定项），可移除SKIP LOCKED，但此时事务会等待锁释放，存在死锁风险，需根据场景选择
• 两种方案均为原子操作，在数据库层面完成筛选与更新，彻底规避两步操作的竞态问题

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