Prisma搭建带额外字段的人员亲属自关联模型外键配置问题

现有模型配置失败有两个直接原因：

• 亲属关系是两个Person实体间的双向关联，当前Relationship表仅设置了1个指向Person的外键，无法完整表达「甲和乙存在某类亲属关系」的基础逻辑
• Prisma规则要求：同一模型内存在多个指向同一目标模型的关联时，必须显式指定关联名称，否则框架无法匹配字段与反向关联的对应关系，直接抛出外键配置错误。

model Person {
  id              Int             @id @default(autoincrement())
  name            String
  slug            String          @unique
  // 当前用户作为关系主体的关联（例：甲是乙的父亲，甲为主体）
  fromRelationships Relationship[] @relation("personFromRel")
  // 当前用户作为关系客体的关联（例：甲是乙的父亲，乙为客体）
  toRelationships   Relationship[] @relation("personToRel")
}

model Relationship {
  id            Int       @id @default(autoincrement())
  fromPerson    Person    @relation("personFromRel", fields: [fromPersonId], references: [id])
  fromPersonId  Int
  toPerson      Person    @relation("personToRel", fields: [toPersonId], references: [id])
  toPersonId    Int
  relation      Relation  @relation(fields: [relationId], references: [id])
  relationId    Int
  startDate     DateTime?
  endDate       DateTime?

  // 联合唯一约束，避免重复录入完全相同的关系数据
  @@unique([fromPersonId, toPersonId, relationId])
}

model Relation {
  id              Int             @id @default(autoincrement())
  name            String // 例：父亲、母亲、儿子、女儿、兄长
  // 可选配置：绑定反向关系，查询时自动映射，例：父亲的反向关系是子女
  reverseRelationId Int?
  reverseRelation   Relation? @relation("relationReverse", fields: [reverseRelationId], references: [id])
  inverseOf       Relation?       @relation("relationReverse")
  relationships   Relationship[]
}

• 关联字段不要随意加可选标记?：有效亲属关系必须绑定两个自然人、一个明确的关系类型，去掉可选标记可以从数据库层面拦截空值脏数据
• 两个指向Person的关联分别配置了独立的显式关联名personFromRel、personToRel，Prisma可以正确匹配正反关联关系，不会再报外键配置错误
• Relation表的反向关系为可选配置，如果业务不需要自动映射反向亲属关系，可以删除相关字段，仅保留name和relationships即可
• Relationship表的联合唯一约束可以根据业务需求调整，如果允许同一对人之间存在多个关系类型（比如既是同事又是亲戚），可以保留多类型记录，仅约束同主体、同客体、同关系类型的记录不重复。

录入「id为1的张三是id为2的李四的父亲（父亲类型对应id=1）」：

await prisma.relationship.create({
  data: {
    fromPersonId: 1,
    toPersonId: 2,
    relationId: 1
  }
})

查询某个人的所有亲属关系时，同时查询fromRelationships和toRelationships两个方向的记录，合并后即可拿到完整的亲属关系列表。

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