CardVerse 是我开源的数字商品与卡密发货项目,后端用 NestJS、Prisma 和 MySQL。这次补博客,回头看了一下 3 月的订单结算代码。
支付成功以后,系统需要记录支付结果、分配库存、保存发货内容,再发送邮件和业务 Webhook。正常路径并不长,但把这些操作包进事务,只解决了一部分问题。
这篇直接按 OrderWorkflowService 里的现有代码复盘。有些是当前做法,有些是后面应该补的地方,下面会分开说明。没有做真实支付联调或并发压测,也不把代码推导当作已经观测到的线上事故。
先看正常的结算路径
支付渠道通知和零元订单最终会进入同一个 finalizeOrderSettlement()。其中零元订单跳过支付记录创建,但仍然执行后续发货逻辑。
结算函数在事务里重新读取订单,随后根据商品的发货方式分支:
| 发货方式 | 事务内的主要操作 | 正常完成后的订单状态 |
|---|---|---|
| 手动发货 | 检查并扣减手动库存,记录付款 | PAID |
| 自动发货 | 选取卡密、标记售出、保存订单卡密快照和发货记录 | DELIVERED |
自动发货保存快照,是为了把“这次交付的内容”保存在订单关系里。之后查看订单时,不必只依赖库存表当前的卡密内容。
邮件和业务 Webhook 则在数据库事务完成后触发。它们不应该在事务中等待:外部服务的响应时间不可控,等待邮件服务器期间一直占着数据库事务没有必要。
写完失败状态再抛异常,状态也会消失
库存不足的分支中,现在有这样的结构。下面是删去无关字段后的代码:
1 | await prisma.$transaction(async tx => { |
这段文字提示和事务语义是冲突的。回调抛出异常,Prisma 会回滚整个事务,刚写入的 FAILED 也在回滚范围内。同一个事务里创建的支付记录同样不会保留。
因此不能因为代码调用过一次 update,就认为订单最终一定是 FAILED。这里需要看事务是否提交。
如果要保留一次业务失败,可以在事务中写入失败记录并正常返回一个明确结果,由外层转换成响应。另一种情况是事务本身执行失败,则在回滚以后另行记录失败,但要用条件更新,避免覆盖已经被其他请求推进的订单。
对于已收到真实付款、却没有库存的订单,还要单独考虑“付款已确认、交付待处理”的状态。支付平台发生的收款,不会随着本地事务回滚而撤销。这个状态如何补发、退款和对账,需要业务流程承接,不能只返回一个库存不足的异常。
以上是改进方向,本文对应的提交还保留着前面这段回滚问题。
查两次订单状态,不等于解决并发重复通知
现有代码在事务外检查一次订单,在事务内又检查一次:如果已经是 PAID 或 DELIVERED,就直接返回现有数据。
它能处理后到的重复通知。但两个通知同时进入时,可能都在另一个请求提交前读到旧状态,然后都继续结算。
所以这里要区分“重复请求按顺序到达”和“多个请求同时执行”。仅有状态判断,还不足以宣称并发情况下只会发一次货。
一种可考虑的做法是在事务里先锁定订单行,再基于锁定后的状态推进;也可以设计带状态条件的原子更新,检查实际影响行数。支付记录还可以根据渠道语义补上唯一约束,防止同一支付事件被重复记账。
这些机制需要一起设计。单独加一个进程内锁,无法覆盖服务重启或多个实例;单独加一个唯一索引,也不会自动解决所有库存竞争。
库存竞争是另一个问题
自动发货现在先 findMany 查出 UNUSED 卡密,再按这些 ID 执行 updateMany。更新条件里只有 ID,没有再次要求 status = UNUSED。
假设两个订单都需要最后一张卡密,它们可能先后读到同一张库存。后续写入即使发生等待,也不能靠“都放在事务里”就推导出每张卡一定只交付给一个订单。当前更新条件和数据约束还需要进一步收紧。
可选方向包括锁定待分配库存行,或者使用带库存状态条件的更新,检查实际占用数量,不足时回滚本次分配。若使用 FOR UPDATE 等方式,还要考虑查询索引、锁范围、死锁重试和批量取卡顺序。
手动库存也类似。先读取数量、再执行递减,中间存在竞争窗口。条件扣减要让“库存足够”和“扣库存”成为同一次受保护的操作。
事务保证的是一组操作提交或回滚;是否存在超卖,还取决于读取方式、隔离级别、更新条件和约束。
数据库提交了,Webhook 仍然可能没发出去
目前业务 Webhook 在事务后通过 void this.sendProductWebhook(...) 发起。失败会记录日志,不阻塞订单返回,也没有持久化的 Webhook 投递队列。
这样可以避免外部系统拖住结算,但存在一个窗口:数据库已经提交,进程却在发出请求之前退出。还有一种情况是对方已经处理请求,本地没有收到响应。这两个问题都不能用数据库回滚解决。
如果 Webhook 只是附加通知,记录日志后人工补偿也许够用。如果它负责开通服务,就需要更可靠的投递机制,例如事务 Outbox:
- 在订单事务中同时写入待投递事件。
- 独立 worker 读取事件并发送,失败时保留记录、安排重试。
- 使用稳定的事件 ID,让接收方去重。
这通常提供的是至少一次投递,接收方仍然要幂等处理。它是后续可以补的方案,当前版本没有实现这套 Outbox。
下一轮应该验证哪些场景
如果继续改这块,我会优先检查以下场景,而不只是再跑一遍正常下单:
- 两个支付通知并发结算同一订单,是否只产生一次有效交付。
- 两个订单竞争最后一张卡密,是否只有一个成功占用。
- 付款后库存不足,付款事实与待处理原因是否能查到。
- 事务提交后立即停止进程,恢复后外部通知能否补发。
- Webhook 接收方处理成功但响应丢失,重试是否会重复开通服务。
把这些场景跑通之后,才适合讨论发货可靠性。代码里有 $transaction 是起点,订单最终留下什么状态、库存归谁、外部系统是否收到通知,还要分别核对。
本文对应 2026-03-19 的版本 5df10fc。相关源码:订单结算服务、数据库模型。