使用Prisma upsert操作Profile表异常：无对应id时无法创建记录

问题场景 #

我在使用Prisma对Profile表执行upsert操作时遇到异常：当where条件中的id不存在（此时console.log(id)返回undefined）时，无法创建新记录；但手动添加关联用户的Profile记录后，upsert可以正常更新该记录。

表结构定义 #

model Profile {
  id       String  @id @default(cuid())
  username String?
  about    String?
  url      String?
  company  String?
  userId   String
  user     User    @relation(fields: [userId], references: [id])
}

当前Upsert代码 #

const userId = session.user.id;
const { id, username, about, url, company } = req.body;

const createOrUpdateProfile = await prisma.profile.upsert({
  where: { id: id },
  update: {
    username: username,
    about: about,
    url: url,
    company: company,
  },
  create: {
    username: username,
    about: about,
    url: url,
    company: company,
    user: { connect: { id: userId } },
  },
});

问题原因分析 #

1. 无效的查询条件：创建新Profile时，前端未传入有效的id（值为undefined），此时where: { id: undefined }是无效的唯一字段查询条件。尽管Prisma设计上会在匹配不到记录时触发create，但undefined作为查询值可能导致逻辑异常，直接终止创建流程。
2. 业务逻辑与查询条件不匹配：从关联关系看，Profile属于User，通常业务场景是一个用户对应一个Profile，但当前模型未给userId添加@unique约束，也未用userId作为upsert的匹配依据，导致无法基于用户身份判断是否需要创建新记录。
3. 缺失错误捕获：代码中未添加错误处理逻辑，无法得知create失败的具体原因（如userId不存在、字段验证失败等）。

解决方案 #

方案1：添加错误捕获定位问题 #

先通过try/catch捕获错误，打印具体信息排查根因：

const userId = session.user.id;
const { id, username, about, url, company } = req.body;

try {
  const createOrUpdateProfile = await prisma.profile.upsert({
    where: { id: id },
    update: {
      username: username,
      about: about,
      url: url,
      company: company,
    },
    create: {
      username: username,
      about: about,
      url: url,
      company: company,
      user: { connect: { id: userId } },
    },
  });
} catch (error) {
  console.error('Upsert失败详情:', error);
}

方案2：基于用户身份实现Upsert（推荐） #

如果业务上一个User对应一个Profile，先修改模型给userId添加唯一约束：

model Profile {
  id       String  @id @default(cuid())
  username String?
  about    String?
  url      String?
  company  String?
  userId   String  @unique // 添加唯一约束，确保用户与Profile一一对应
  user     User    @relation(fields: [userId], references: [id])
}

再修改upsert代码，用userId作为匹配条件：

const userId = session.user.id;
const { username, about, url, company } = req.body; // 无需从请求体获取id

const createOrUpdateProfile = await prisma.profile.upsert({
  where: { userId: userId },
  update: {
    username: username,
    about: about,
    url: url,
    company: company,
  },
  create: {
    username: username,
    about: about,
    url: url,
    company: company,
    userId: userId, // 直接关联用户，语法更简洁
  },
});

这种方式无需依赖前端传递Profile的id，完全基于用户身份自动判断创建或更新，更贴合业务逻辑。

方案3：支持多Profile场景（如果业务允许） #

若业务允许一个用户拥有多个Profile，需确保前端在创建新记录时传递有效的id（如提前生成cuid），或让Prisma自动生成id（此时请求体不传递id）。可拆分逻辑处理：

const userId = session.user.id;
const { id, username, about, url, company } = req.body;

if (!id) {
  // 无id时直接创建新Profile
  const createProfile = await prisma.profile.create({
    data: {
      username: username,
      about: about,
      url: url,
      company: company,
      user: { connect: { id: userId } },
    },
  });
} else {
  // 有id时执行upsert
  const updateProfile = await prisma.profile.upsert({
    where: { id: id },
    update: {
      username: username,
      about: about,
      url: url,
      company: company,
    },
    create: {
      username: username,
      about: about,
      url: url,
      company: company,
      user: { connect: { id: userId } },
    },
  });
}

内容的提问来源于stack exchange，提问作者Mathias Riis Sorensen