Prisma.io自关联一对多生成唯一键导致多记录关联失败问题

问题根因 #

你遇到的是Prisma 2.27.0及更早版本的已知缺陷：当定义一对多自关联时，若未显式指定关联名称与对应外键字段，Prisma会错误将其识别为一对一关联，自动为外键字段生成UNIQUE约束，导致多条记录无法关联到同一父记录，仅最新的关联会生效。由于Prisma生成外键时默认参照该自动创建的唯一键，因此直接删除唯一键时会触发数据库外键依赖错误。

修复方案 #

• 优先升级Prisma版本：该问题在2.30.0及后续版本已被官方修复，升级后执行prisma migrate dev即可自动修正错误约束，无需手动修改数据库。
• 若暂时无法升级，可手动调整Schema定义，显式声明关联规则避免自动生成唯一约束，示例如下：

model Category {
  id        Int      @id @default(autoincrement())
  name      String
  // 父级关联：显式指定关联名、绑定外键字段
  parent    Category? @relation("CategoryHierarchy", fields: [parentId], references: [id])
  // 外键字段不加@unique约束
  parentId  Int?
  // 子级关联：和父级关联使用相同关联名绑定，明确一对多关系
  children  Category[] @relation("CategoryHierarchy")
}

调整完成后执行prisma migrate dev --name fix-self-rel-unique生成新迁移，Prisma会自动删除错误的唯一键，同时保留外键关联完整性，不会触发数据库删除限制。

• 若生产环境已有存量数据无法直接执行迁移，可先备份数据，在数据库层面先删除绑定该唯一键的外键，再删除唯一键，最后重新创建不带唯一约束的外键即可。

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