基于Prisma构建数字电商MongoDB数据库的模型优化及关系疑问

是否需要建立显式关系？ #

建议建立显式关系，原因如下：

• 数据一致性：Prisma会在应用层校验关联的Product是否存在，避免出现引用无效商品ID的情况，即使MongoDB本身不支持外键约束，Prisma的关系系统也能帮你维护数据完整性。
• 查询效率与便捷性：通过显式关系，你可以直接在查询CartItem/OrderItem时关联获取Product的详细信息，无需单独执行两次查询，比如：

  const cartWithProducts = await prisma.cart.findUnique({
    where: { userId: "xxx" },
    include: { cartItems: { include: { product: true } } }
  });
  

• 代码可读性：显式的关系定义让模型结构更清晰，团队成员能快速理解数据之间的关联逻辑。

优化后的Prisma模型代码 #

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

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

model User {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  firstname String
  lastname String
  email String @unique
  password String

  cart Cart? // 一对一关联Cart
  orders Order[] // 一对多关联Order
  sessions Session[] // 一对多关联Session
  resetPasswordTokens ResetPasswordToken[] // 用户与重置令牌的关系

  @@map("users")
}

model Session {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  active Boolean @default(true)
  userAgent String?

  userId String @db.ObjectId
  user User @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@map("sessions")
}

model ResetPasswordToken {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  expiresAt DateTime

  token String @unique
  userId String @db.ObjectId
  isValid Boolean @default(true)
  user User @relation(fields: [userId], references: [id], onDelete: Cascade) // 关联用户

  @@map("reset_password_tokens")
}

model Cart {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  cartItems CartItem[] // 一对多关联CartItem

  userId String @unique @db.ObjectId
  user User @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@map("carts")
}

model CartItem {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  quantity Int
  productId String @db.ObjectId
  product Product @relation(fields: [productId], references: [id], onDelete: Restrict) // 关联Product，删除商品时阻止删除关联购物车项
  cartId String @db.ObjectId
  cart Cart @relation(fields: [cartId], references: [id], onDelete: Cascade)

  @@unique([cartId, productId]) // 同一购物车中同一商品只能存在一项，避免重复添加
  @@map("cart_items")
}

model Order {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  status Status
  totalPrice Decimal @db.Decimal // 用Decimal替代Float，避免精度问题

  orderItems OrderItem[] // 一对多关联OrderItem

  userId String @db.ObjectId
  user User @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@map("orders")
}

enum Status {
  PENDING
  CANCELED
  COMPLETED
}

model OrderItem {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  quantity Int
  productId String @db.ObjectId
  product Product @relation(fields: [productId], references: [id], onDelete: Restrict) // 关联Product，删除商品时不影响已生成的订单
  orderId String @db.ObjectId
  order Order @relation(fields: [orderId], references: [id], onDelete: Cascade)

  @@map("order_items")
}

model Product {
  id String @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  name String
  url String
  description String
  price Decimal @db.Decimal // 用Decimal替代Float

  cartItems CartItem[] // 反向关联CartItem
  orderItems OrderItem[] // 反向关联OrderItem

  @@map("products")
}

其他优化说明 #

1. 价格字段改用Decimal：电商场景中价格需要精确计算，Float类型存在精度丢失问题，Decimal类型能保证数值准确性，适配MongoDB的Decimal128类型。
2. CartItem新增复合唯一键：@@unique([cartId, productId])确保同一用户购物车中同一商品只会存在一条记录，添加重复商品时只需更新quantity字段即可。
3. ResetPasswordToken关联User：方便查询用户的所有重置令牌，也能在删除用户时自动清理相关令牌（通过onDelete: Cascade）。
4. 关系删除策略：
   • CartItem/OrderItem与Product的关系使用onDelete: Restrict，防止误删商品导致购物车或订单数据失效；
   • 其他关联使用onDelete: Cascade，删除主数据时自动清理关联的子数据（比如删除用户时删除其购物车、订单等）。

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