GORM软删除下唯一索引冲突问题及GORM内解决方案咨询

我使用GORM的联合唯一索引约束元素的排序逻辑，定义的结构体如下：

type Element struct {
  gorm.Model
  ID         int            `gorm:"primary_key"`
  Index      int            `gorm:"uniqueIndex:unique_order"`
  ParentID   int            `gorm:"uniqueIndex:unique_order"`
}

但在创建并软删除多个元素后，出现了唯一约束冲突错误：

ERROR: duplicate key value violates unique constraint "unique_order" (SQLSTATE 23505)

原因是GORM的软删除仅标记deleted_at字段，被删除的记录仍存在于数据库中，导致新增记录时触发唯一索引约束。已知可通过PostgreSQL部分索引解决，但想了解是否能通过GORM本身处理该问题？

1. 将deleted_at加入联合唯一索引 #

把软删除字段deleted_at纳入联合唯一索引的组成部分，利用PostgreSQL中NULL不参与唯一约束的特性：未删除的记录deleted_at为NULL，因此相同Index和ParentID的未删除记录只能存在一条；而软删除的记录deleted_at有值，不会与未删除记录的(Index, ParentID, NULL)组合冲突，也不会和其他软删除记录冲突（除非deleted_at完全相同，但软删除时间通常是唯一的）。

修改结构体标签如下：

type Element struct {
  gorm.Model
  ID         int            `gorm:"primary_key"`
  Index      int            `gorm:"uniqueIndex:unique_order"`
  ParentID   int            `gorm:"uniqueIndex:unique_order"`
  // 把deleted_at加入联合唯一索引
  DeletedAt  gorm.DeletedAt `gorm:"uniqueIndex:unique_order"`
}

注意：如果业务中存在同一时间批量软删除多条相同Index和ParentID的记录，可额外添加ID字段到索引中避免冲突，这类场景实际极少出现。

2. 手动校验未删除记录（应用层约束） #

在创建新元素前，通过GORM的查询方法先校验是否存在未删除的、相同Index和ParentID的记录，只有不存在时才执行创建操作。这种方式属于应用层校验，存在并发场景下的竞态风险，需结合业务场景评估适用性。

示例代码：

import "errors"

func CreateElement(db *gorm.DB, elem *Element) error {
  var count int64
  // 查询未删除的相同Index和ParentID的记录数量
  err := db.Model(&Element{}).Where("index = ? AND parent_id = ?", elem.Index, elem.ParentID).
    Where("deleted_at IS NULL").Count(&count).Error
  if err != nil {
    return err
  }
  if count > 0 {
    return errors.New("已存在相同排序的未删除元素")
  }
  return db.Create(elem).Error
}

3. 禁用软删除（业务允许时） #

如果业务不需要保留软删除记录，可以直接禁用GORM的软删除特性，改用物理删除。这样删除的记录会从数据库中彻底移除，不会触发唯一索引冲突。

修改结构体，去掉自带软删除的gorm.Model，手动定义需要的字段：

import "time"

type Element struct {
  ID        int       `gorm:"primary_key"`
  CreatedAt time.Time
  UpdatedAt time.Time
  Index     int       `gorm:"uniqueIndex:unique_order"`
  ParentID  int       `gorm:"uniqueIndex:unique_order"`
}

此时执行db.Delete(&elem)会直接物理删除记录。

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