Prisma Upsert报错：payload参数需为对象，接收到null

错误信息 #

⨯ [TypeError: The "payload" argument must be of type object. Received null] {
  code: 'ERR_INVALID_ARG_TYPE',
  digest: '447529059'
}

场景说明 #

在通过Server Action实现Lesson及关联资源的保存/更新（按需创建或更新关联记录）时触发该错误，已尝试不同upsert写法、循环逻辑，TypeScript未检测到数据传递异常，但问题仍存在。

排查与解决步骤 #

1. 检查Server Action接收的参数是否为null #

• 前端调用Server Action时，可能存在表单数据未正确收集、状态值初始化错误等场景，导致传入参数为null。
• 在Server Action开头添加日志，确认接收的参数值：

  export async function saveLesson(data: LessonFormData) {
    console.log('Received data:', data); // 确认此处是否为null
    // 后续Prisma操作逻辑
  }
  

2. 排查Prisma操作中的null payload #

• 检查Prisma的upsert/create/update方法，是否存在将null传递给要求为对象类型的参数（比如关联表的connect/create配置）：
  错误示例：

  await prisma.lesson.upsert({
    where: { id: lessonId },
    update: {
      resources: {
        connect: null, // 此处传递null触发报错
      },
    },
    create: { /* ... */ },
  });
  

• 修复方式：通过条件判断确保对象类型参数不为null：

  await prisma.lesson.upsert({
    where: { id: lessonId },
    update: {
      ...(resources && { resources: { connect: resources.map(r => ({ id: r.id })) } }),
    },
    create: { /* ... */ },
  });
  

3. 检查中间处理逻辑的null输出 #

• 若Server Action中有数据转换、预处理逻辑，确认转换后的结果是否为null。比如工具函数处理数据时返回null，未做校验就传入Prisma方法。

额外提示 #

即使TypeScript未报错，运行时仍可能出现null值（比如可选链操作后的undefined、外部不可信数据），建议在关键位置添加非空校验：

if (!data) {
  throw new Error('Invalid lesson data received');
}

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