weiyi
项目ReTrade

支付幂等与资金事务

同一次请求的重放、不同请求的竞争和响应丢失,需要三种相互配合的判断。

支付为什么需要两层幂等

站内钱包支付会遇到两种并发。同一个 pay_request_id 可能因连点或超时被重发,不同请求 ID 也可能同时支付同一订单。支付日志的唯一键约束同一次请求,订单行锁与状态机约束同一个业务对象。

处理成功后响应丢失时,调用方还会再请求一次。服务需要根据已提交的订单和流水返回既有结果,让重试能够收敛。

先获得请求处理权

入口校验订单快照和买家身份。旧客户端没有提交请求 ID 时,材料使用由订单号和用户 ID 构成的稳定键兼容。该键会把同一订单的多次尝试归到同一意图,未来切换支付渠道时需要重新定义语义。

PaymentLog 在主交易事务之前抢占 processing 状态。同键已经成功则返回原结果,仍在有效处理窗口内则返回处理中,失败或超时记录通过条件更新竞争接管权。

日志先行能够减少重试请求进入主事务的数量,也留下了前置 processing 与实际业务提交之间的恢复问题。接管时必须重新检查订单事实,错误路径更新日志时也应带执行权或版本条件,避免旧请求覆盖新请求结果。

主事务内部做什么

主事务依次锁订单、普通商品和买家钱包。拿到订单行锁后重新检查买家、订单状态、支付状态及过期时间,再确认商品可售和库存条件。锁查询必须通过同一个 tx 执行。

随后把余额转入冻结,记录钱包流水,把订单置为已支付,将本次日志置为成功,扣减普通商品库存并记录库存流水。这组事实一起提交。秒杀订单已经在异步落单时处理活动库存,其支付路径需要识别订单来源。

下面是需要保持的不变量,具体表名按实现对应。

订单最多完成一次有效支付迁移
钱包可用余额减少值 = 对应冻结余额增加值
库存扣减与成功业务数量一致
钱包流水与库存流水能够关联到订单和请求

行锁和条件更新怎样配合

两个不同请求都可能创建自己的支付日志,但会竞争同一订单记录。第一个事务提交后,第二个事务拿锁再检查时能看到订单已支付,从而结束本次扣款路径。

库存还应使用 num >= 购买量 之类的数据库条件,并检查实际更新行数。应用层先读再减存在竞争窗口,条件更新则把判断和写入放到数据库的同一个原子操作中。

固定锁顺序降低环形等待概率。事务中只保留必要读写,ES、RPC 和 Kafka 等外部操作在提交后或通过可靠事件推进。死锁和锁等待超时仍可能出现,重试要保留原请求身份。

崩溃发生后依据什么恢复

崩溃位置 数据库事实 重试处理
主事务提交前 资金、库存和订单一起回滚 processing 超时后可以接管,再查业务状态
提交成功、响应返回前 订单、钱包和流水已经生效 返回既有成功结果,终止重复扣款
支付与取消并发 两条路径竞争订单记录 后获得锁的一方依据新状态结束
提交后搜索更新失败 交易事实已成立,搜索仍可能旧 由异步同步或补偿重建读模型

支付路径里顺便更新过期订单再返回事务错误,会使取消动作也回滚。因此过期取消的提交结果与对用户返回的业务错误必须分别设计,后台超时任务承担独立恢复入口。

怎样验证它真的只扣一次

使用同键并发、异键同订单并发、响应丢失、超时接管和支付取消竞争等场景。测试后联合核对订单、支付日志、钱包、库存和两类流水。还要在事务中途注入故障,确认写入共同回滚。

第三方真实支付会增加结果未知窗口,届时需要按商户单号主动查单和外部流水核对。当前站内钱包事务能够解释本地资金变化,接入支付机构后还要建立跨系统对账。

本文整理依据

内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。

  • ReTrade Agent Mall/Mall/2.支付链路复习.md
  • ReTrade Agent Mall/Mall/8.db和tx事务边界笔记.md
  • ReTrade Agent Mall/0-简历分析/简历题分析.md