如何修复Prisma的‘变更违反必填关联’（P2014）错误？

问题根源 #

1. Schema约束冲突：PublicKey模型的ownerId字段设置了@unique，这强制每个用户只能关联一条PublicKey记录——哪怕旧密钥已被软删除，只要数据库中存在该用户关联的PublicKey记录，就无法创建新的关联。
2. 事务执行顺序错误：当前事务先执行create再执行update软删除旧密钥，创建新密钥时，旧密钥的ownerId仍绑定该用户，直接触发唯一约束违反，导致P2014错误。

修复方案 #

方案一：支持多历史密钥（推荐） #

如果需要保留用户的密钥历史记录，仅维持一个活跃密钥，需修改Prisma Schema：

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

enum Role {
  ADMIN
  USER
}

model PublicKey {
  id String @id @default(uuid())
  key String @unique
  ownerId String  // 移除@unique约束
  owner User @relation(fields: [ownerId], references: [id])
  deletedAt DateTime?
  keyActivities KeyActivity[]
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  // 新增唯一索引：确保每个用户仅存在一条未删除的活跃密钥
  @@unique([ownerId, deletedAt], name: "active_public_key_per_user")
}

model User{
  id String @id
  role Role
  publicKeys PublicKey[]  // 从单个PublicKey改为一对多列表
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

方案二：仅替换密钥（不保留历史） #

如果不需要保留历史密钥，仅需替换当前密钥，可调整事务执行顺序，先软删除旧密钥再创建新密钥：

export async function createPublicKeyAndDeleteOld(data: CreateKeyData) {
  const activePublicKey = await getActivePublicKey(data.ownerId);

  if (activePublicKey) {
    await db.$transaction([
      // 先软删除旧密钥，释放ownerId关联
      db.publicKey.update({
        where: { id: activePublicKey.id },
        data: { deletedAt: new Date() },
      }),
      // 再创建新密钥
      db.publicKey.create({
        data: {
          key: data.key,
          owner: { connect: { id: data.ownerId } },
        },
      }),
    ]);
  } else {
    return await createPublicKey(data);
  }
}

补充说明 #

• 若不需要软删除功能，直接更新旧密钥的key字段更高效，无需创建新记录。
• 方案一中的唯一索引利用PostgreSQL特性：deletedAt为null时，每个用户仅能有一条该值的记录，确保活跃密钥唯一性；历史记录因deletedAt为时间戳（几乎唯一），不会触发索引冲突。

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