React / 系统课时

关联查询与事务

关联查询与事务

本课用一个“创建订单并扣减库存”的场景,演示如何通过 Prisma 查询关联数据,以及如何把多步写入放进同一事务,确保它们要么全部成功,要么全部回滚。

学习目标

  • 使用 include 与 select 查询模型之间的关联数据
  • 使用交互式事务完成依赖前一步结果的多步写入
  • 识别事务边界、异常回滚与并发更新的关键风险

准备数据模型

下面的模型包含用户、订单、订单项和商品库存。关系字段负责在 Prisma Client 中建立对象导航,真正存储关联的是 userId、orderId 和 productId 等外键字段。

prisma
model User {
  id     Int     @id @default(autoincrement())
  email  String  @unique
  orders Order[]
}

model Product {
  id         Int         @id @default(autoincrement())
  name       String
  price      Decimal     @db.Decimal(10, 2)
  stock      Int
  orderItems OrderItem[]
}

model Order {
  id        Int         @id @default(autoincrement())
  userId    Int
  total     Decimal     @db.Decimal(10, 2)
  createdAt DateTime    @default(now())
  user      User        @relation(fields: [userId], references: [id])
  items     OrderItem[]
}

model OrderItem {
  id        Int     @id @default(autoincrement())
  orderId   Int
  productId Int
  quantity  Int
  price     Decimal @db.Decimal(10, 2)
  order     Order   @relation(fields: [orderId], references: [id])
  product   Product @relation(fields: [productId], references: [id])
}

这是数据结构定义,不直接产生控制台输出。执行迁移并重新生成 Prisma Client 后,可通过 Prisma Studio 或数据库客户端确认四张表及其外键已经创建。

查询关联数据

include 适合在返回主模型全部标量字段的同时附带关联对象;select 适合精确控制返回字段。二者可以逐层嵌套,但同一层不能同时使用顶级 include 和顶级 select。

下面是片段示例,依赖前述模型、已生成的 Prisma Client,以及数据库中已经存在的订单数据。

ts
import { PrismaClient } from "@prisma/client";

const prisma = new PrismaClient();

async function main() {
  const orders = await prisma.order.findMany({
    orderBy: { createdAt: "desc" },
    select: {
      id: true,
      total: true,
      user: {
        select: { email: true },
      },
      items: {
        select: {
          quantity: true,
          price: true,
          product: {
            select: { name: true },
          },
        },
      },
    },
  });

  const output = orders.map((order) => ({
    ...order,
    total: order.total.toString(),
    items: order.items.map((item) => ({
      ...item,
      price: item.price.toString(),
    })),
  }));

  console.dir(output, { depth: null });
}

main()
  .catch(console.error)
  .finally(() => prisma.$disconnect());

预期输出如下,实际 <ID>、金额和商品名称取决于数据库内容。

text
[
  {
    id: <ID>,
    total: '199.00',
    user: { email: 'demo@example.com' },
    items: [
      {
        quantity: 1,
        price: '199.00',
        product: { name: 'Mechanical Keyboard' }
      }
    ]
  }
]

关联查询的核心不是“自动联表越多越好”,而是只取当前接口真正需要的数据。层级过深或一次返回大量子记录时,应改用分页、拆分查询或专用统计 SQL。

用事务完成订单写入

创建订单通常包含读取库存、扣减库存、创建订单和写入明细。只要其中一步失败,前面已经执行的写入就必须撤销,因此这些操作应放进同一个交互式事务。

订单创建事务执行流程

片段示例:下面代码依赖已存在的用户和商品记录。updateMany 同时把库存条件和扣减动作交给数据库完成,可避免“先查询后更新”之间被其他请求抢先修改库存。

ts
import { PrismaClient } from "@prisma/client";

const prisma = new PrismaClient();

async function createOrder(userId: number, productId: number, quantity: number) {
  return prisma.$transaction(async (tx) => {
    const product = await tx.product.findUniqueOrThrow({
      where: { id: productId },
      select: { id: true, name: true, price: true, stock: true },
    });

    const updated = await tx.product.updateMany({
      where: {
        id: product.id,
        stock: { gte: quantity },
      },
      data: {
        stock: { decrement: quantity },
      },
    });

    if (updated.count !== 1) {
      throw new Error("库存不足");
    }

    const total = product.price.mul(quantity);

    return tx.order.create({
      data: {
        userId,
        total,
        items: {
          create: {
            productId: product.id,
            quantity,
            price: product.price,
          },
        },
      },
      include: {
        items: true,
      },
    });
  });
}

预期结果:库存充足时返回新订单及订单项,库存减少对应数量;库存不足时抛出 库存不足,订单和订单项都不会写入,库存也保持不变。

事务边界与验证

事务应只包住必须保持一致的数据库操作。不要在事务回调中发送邮件、调用支付接口或执行长时间网络请求,否则会延长锁持有时间,并增加超时和死锁概率。

验证时可以故意把购买数量改成大于库存的值,再查询订单数和商品库存。若订单数未增加、库存未变化,说明回滚生效;随后使用正常数量重试,确认订单与库存同时更新。

Tips:批量执行彼此独立的 Prisma 操作,可使用 prisma.$transaction([operation1, operation2]);需要读取前一步结果再决定后一步时,应使用交互式事务回调。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

关联查询与事务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通