Prisma v2软删除后插入重复person_name触发唯一约束报错求解决思路

针对你遇到的软删除后无法插入同名记录的问题，这里有几个可行的解决方案：

方案1：使用复合唯一约束 #

把person_name和deleted字段组合成唯一约束，这样只有**未删除（deleted=false）**的记录会强制person_name唯一，软删除的记录不会干扰新插入的同名数据。

修改你的Prisma Schema：

model Person {
  id          Int      @id @default(autoincrement())
  person_name String
  deleted     Boolean  @default(false)

  // 复合唯一约束：仅活跃记录保持person_name唯一
  @@unique([person_name, deleted])
}

原理：当插入新记录时，deleted默认是false，只有当存在另一条person_name相同且deleted=false的记录时才会触发唯一冲突；而软删除的记录（deleted=true）和新插入的deleted=false记录，因为组合键不同，不会触发约束。

方案2：应用层前置检查（自定义逻辑） #

在插入新记录前，先查询是否存在未删除的同名记录，只有不存在时才执行插入操作。

示例代码（TypeScript）：

async function createPerson(personName: string) {
  // 检查是否有未删除的同名记录
  const activePerson = await prisma.person.findFirst({
    where: {
      person_name: personName,
      deleted: false
    }
  });

  if (activePerson) {
    throw new Error("该名称已存在活跃记录");
  }

  // 插入新记录
  return await prisma.person.create({
    data: { person_name: personName }
  });
}

注意：这个方案存在竞态风险——如果两个请求同时执行检查，都没找到活跃记录，会同时插入导致唯一冲突。如果要避免这个问题，可以结合Prisma事务或者数据库锁来处理。

方案3：数据库部分唯一索引（适合支持的数据库） #

如果你的数据库支持部分索引（比如PostgreSQL、MySQL 8.0+），可以创建一个仅对deleted=false生效的唯一索引，从数据库层面保证活跃记录的唯一性。

1. 先移除Prisma Schema中person_name的单字段唯一约束
2. 创建自定义迁移脚本，添加部分唯一索引：

-- PostgreSQL示例
CREATE UNIQUE INDEX unique_active_person_name ON "Person" ("person_name") WHERE "deleted" = false;

-- MySQL 8.0+示例
CREATE UNIQUE INDEX unique_active_person_name ON `Person` (`person_name`) WHERE `deleted` = 0;

这个方案的优势是直接在数据库层面实现约束，比应用层逻辑更可靠，也不会像复合约束那样产生多余的索引条目。

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