本地使用Prisma对接CockroachDB时外键约束及connect关联报错如何解决

1. Prisma的CockroachDB预览支持适配不完全：当前使用的autoincrement()类型int主键在CockroachDB中默认生成不连续的有序ID，早期预览版Prisma对该类主键的关联校验存在缺陷，会误判已存在的关联记录不存在。
2. 事务隔离级别差异：CockroachDB默认使用可序列化隔离级别，远严格于PostgreSQL默认的读已提交隔离级别，若findFirst查询和后续create操作不在同一事务中，Prisma的预校验查询可能读取不到之前的已提交数据，触发关联不存在报错。
3. 外键校验返回值适配问题：CockroachDB的外键约束报错返回格式和PostgreSQL存在差异，Prisma未完全适配该格式，因此会出现(not available)的未知外键字段提示。

• 替换主键生成策略（推荐长期方案）
  将所有模型的int自增主键替换为CockroachDB原生适配的UUID类型，修改后的schema示例如下：

datasource db {
  provider = "postgresql"
  url      = "postgresql://user:pass@localhost:26257/mydb"
}

generator client {
  provider = "prisma-client-js"
  previewFeatures = ["cockroachdb"]
}

model MyLinkedEntity {
  id           String   @id @default(uuid())
  myEntity     MyEntity @relation(fields: [myEntityId], references: [id])
  myEntityId   String
  // ...其余字段保持不变
}

model MyEntity {
  id   String  @id @default(uuid())
  // ...其余字段保持不变
}

修改后重新生成Prisma客户端和迁移文件，在CockroachDB执行迁移即可解决主键识别异常问题。

• 合并操作到同一事务
  如果暂时无法修改主键结构，可以将关联查询和写入操作放到同一Prisma事务中执行，消除隔离级别带来的快照读差异，示例代码如下：

await prisma.$transaction(async (tx) => {
  const entity = await tx.myEntity.findFirst({})
  await tx.myLinkedEntity.create({
    data: {
      myEntityId: entity.id
      // ...其余字段
    }
  })
})

• 升级Prisma版本
  当前问题在Prisma 4.10及以上版本有大量相关修复，可将Prisma依赖升级到最新稳定版，重新生成客户端后验证问题是否解决。

• 临时绕过Prisma预校验
  开发环境下可在create操作中添加relationLoadStrategy: "query"参数，跳过Prisma层面的关联预校验，直接交给数据库执行外键约束校验，示例代码如下：

await prisma.myLinkedEntity.create({
  data: {
    myEntity: {
      connect: {
        id: entity.id
      }
    }
  },
  relationLoadStrategy: "query"
})

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