React / 系统课时
关联查询与事务
关联查询与事务
本课用一个“创建订单并扣减库存”的场景,演示如何通过 Prisma 查询关联数据,以及如何把多步写入放进同一事务,确保它们要么全部成功,要么全部回滚。
学习目标
- 使用
include与select查询模型之间的关联数据 - 使用交互式事务完成依赖前一步结果的多步写入
- 识别事务边界、异常回滚与并发更新的关键风险
准备数据模型
下面的模型包含用户、订单、订单项和商品库存。关系字段负责在 Prisma Client 中建立对象导航,真正存储关联的是 userId、orderId 和 productId 等外键字段。
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,以及数据库中已经存在的订单数据。
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>、金额和商品名称取决于数据库内容。
[
{
id: <ID>,
total: '199.00',
user: { email: 'demo@example.com' },
items: [
{
quantity: 1,
price: '199.00',
product: { name: 'Mechanical Keyboard' }
}
]
}
]关联查询的核心不是“自动联表越多越好”,而是只取当前接口真正需要的数据。层级过深或一次返回大量子记录时,应改用分页、拆分查询或专用统计 SQL。
用事务完成订单写入
创建订单通常包含读取库存、扣减库存、创建订单和写入明细。只要其中一步失败,前面已经执行的写入就必须撤销,因此这些操作应放进同一个交互式事务。

片段示例:下面代码依赖已存在的用户和商品记录。updateMany 同时把库存条件和扣减动作交给数据库完成,可避免“先查询后更新”之间被其他请求抢先修改库存。
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]);需要读取前一步结果再决定后一步时,应使用交互式事务回调。