NextJS + Prisma(MongoDB)调用错误：updatedAt字段值为null

问题描述 #

更新Prisma Schema后，调用prisma.cart.findUnique()时触发以下错误：

Error:  Invalid 'prisma.cart.findUnique()' invocation:
Error converting field "updatedAt" of expected non-nullable type "DateTime", found incompatible value of "null".

相关代码（lib/db/cart.ts）：

export async function getCart(): Promise<ShoppingCart | null> {
  const session = await getServerSession(authOptions);

  let cart: CartWithProducts | null = null;

  if (session) {
    cart = await prisma.cart.findFirst({
      where: { userId: session.user.id },
      include: { items: { include: { product: true } } },
    });
 } else {
    const localCartId = cookies().get("localCartId")?.value;
    cart = localCartId
      ? await prisma.cart.findUnique({
          where: { id: localCartId },
          include: { items: { include: { product: true } } },
       })
       : null;
  }

  if (!cart) {
    return null;
  }

  return {
    ...cart,
    size: cart.items.reduce((acc, item) => acc + item.quantity, 0),
    subtotal: cart.items.reduce(
      (acc, item) => acc + item.quantity * item.product.price,
      0
    ),
  };
}

Prisma Schema中Cart模型定义：

model Cart {
  id        String     @id @default(auto()) @map("_id") @db.ObjectId
  items     CartItem[]
  userId    String?    @db.ObjectId
  user      User?      @relation(fields: [userId], references: [id], onDelete: Cascade)
  createdAt DateTime   @default(now())
  updatedAt DateTime   @updatedAt

  @@map("carts")
}

原因分析 #

错误并非由localCartId为null导致，而是数据库中已有的Cart文档缺少updatedAt字段。你是在后续更新Schema时才给Cart模型添加了@updatedAt注解，而旧的Cart文档没有这个字段，Prisma尝试将缺失的字段解析为null，但Schema中定义updatedAt为非空的DateTime类型，因此触发类型转换错误。

解决方案 #

方案1：手动补全数据库中旧Cart文档的updatedAt值 #

通过MongoDB工具（Compass或Shell）连接数据库，执行以下命令为所有缺少updatedAt的Cart文档补全字段：

db.carts.updateMany(
  { updatedAt: { $exists: false } },
  { $set: { updatedAt: new Date() } }
)

方案2：临时将updatedAt设为可选（快速恢复开发） #

如果允许updatedAt暂时为空，可以先修改Schema：

updatedAt DateTime? @updatedAt

执行npx prisma generate更新Prisma客户端，之后再补全数据并改回非空定义。

方案3：用Prisma迁移脚本补全数据（生产环境推荐） #

1. 创建新的迁移文件：

npx prisma migrate dev --name add-updatedAt-to-cart

2. 在生成的迁移脚本（prisma/migrations/[timestamp]_add-updatedAt-to-cart/migration.js）中添加补全逻辑：

module.exports = {
  async up(db) {
    // 为所有缺少updatedAt的Cart文档添加字段
    await db.collection('carts').updateMany(
      { updatedAt: { $exists: false } },
      { $set: { updatedAt: new Date() } }
    );
  },
  async down(db) {
    // 回滚逻辑（可选，移除updatedAt字段）
    await db.collection('carts').updateMany(
      { updatedAt: { $exists: true } },
      { $unset: { updatedAt: "" } }
    );
  },
};

3. 执行迁移：

npx prisma migrate dev

注意事项 #

• 修改Schema后，务必确保数据库中的现有数据与Schema定义一致，尤其是新增的必填字段
• 生产环境禁止直接修改数据库数据，必须通过迁移脚本保证数据变更的可追溯性

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