架构与系统设计 / 系统课时
支付结果更新
支付结果更新
支付回调可能重复、乱序甚至并发到达,本课将把“收到成功通知就直接改状态”改造成可校验、可重入、可追踪的状态推进流程,最终实现订单只从合法前置状态更新到目标状态,并能安全处理重复通知和冲突结果。
学习目标
- 理解支付订单状态推进必须同时校验当前状态与目标状态
- 使用条件更新避免并发回调覆盖已确定的支付结果
- 通过更新结果和订单快照区分成功、重复与冲突通知
为什么不能直接覆盖状态
支付平台通常会同时接收渠道异步通知、主动查询结果和内部补偿任务。它们可能针对同一订单并发执行。若代码只按订单号执行 UPDATE pay_order SET status = 'SUCCESS',较晚到达的请求就可能覆盖已经关闭、退款或失败的订单。
安全更新的核心不是“把状态改成什么”,而是“只有当前状态仍满足前置条件时才允许修改”。例如支付成功只能由 PAYING 推进到 SUCCESS;重复的成功通知不需要再次写库;关闭后的成功通知则应记录为冲突并进入人工或补偿处理。

使用条件更新推进状态
下面的 SQL 片段由仓储层绑定参数,只允许 PAYING 状态的订单更新为成功,同时写入渠道流水号和支付时间。version 用于保留乐观锁语义,updated_at 便于审计。
UPDATE pay_order
SET status = 'SUCCESS',
channel_trade_no = :channelTradeNo,
paid_at = :paidAt,
version = version + 1,
updated_at = CURRENT_TIMESTAMP
WHERE order_no = :orderNo
AND status = 'PAYING';预期结果:首次处理合法成功通知时影响 1 行;重复通知、关闭订单或不存在的订单均影响 0 行。
首次成功通知:Affected rows: 1
重复成功通知:Affected rows: 0
状态冲突通知:Affected rows: 0仅凭“影响 0 行”还不能判断具体原因,因此服务层必须重新读取订单快照。若当前已经是 SUCCESS,且渠道流水号一致,应返回幂等成功;若状态为 CLOSED、FAILED,或渠道流水号不一致,则应记录冲突。
在服务层区分三类结果
下面是服务层片段示例,依赖仓储接口的数据库实现。仓储接口负责执行条件更新和查询订单,服务根据更新行数与最新状态返回明确结果。
import java.time.Instant;
import java.util.Objects;
public class PaymentResultService {
private final PayOrderRepository repository;
public PaymentResultService(PayOrderRepository repository) {
this.repository = repository;
}
public UpdateResult markSuccess(String orderNo, String channelTradeNo, Instant paidAt) {
int affected = repository.updatePayingToSuccess(orderNo, channelTradeNo, paidAt);
if (affected == 1) {
return UpdateResult.UPDATED;
}
PayOrder order = repository.findByOrderNo(orderNo);
if (order == null) {
return UpdateResult.NOT_FOUND;
}
// 已成功且渠道流水一致,说明这是重复通知,可安全返回成功。
if (order.status() == PayStatus.SUCCESS
&& Objects.equals(order.channelTradeNo(), channelTradeNo)) {
return UpdateResult.IDEMPOTENT;
}
// 其他状态或流水号不一致都属于业务冲突,不能继续覆盖。
return UpdateResult.CONFLICT;
}
public enum UpdateResult {
UPDATED, IDEMPOTENT, NOT_FOUND, CONFLICT
}
public enum PayStatus {
CREATED, PAYING, SUCCESS, FAILED, CLOSED
}
public record PayOrder(String orderNo, PayStatus status, String channelTradeNo) {
}
public interface PayOrderRepository {
int updatePayingToSuccess(String orderNo, String channelTradeNo, Instant paidAt);
PayOrder findByOrderNo(String orderNo);
}
}预期结果:合法首次通知返回 UPDATED,相同渠道流水号的重复通知返回 IDEMPOTENT,订单不存在返回 NOT_FOUND,非法状态推进或流水号不一致返回 CONFLICT。
UPDATED
IDEMPOTENT
NOT_FOUND
CONFLICT实际项目中,CONFLICT 不应只写普通日志。建议记录订单号、当前状态、目标状态、渠道流水号和通知来源,并发送到告警或补偿队列,避免真正的支付成功被静默丢弃。
事务与后续动作边界
订单状态更新、支付流水写入和本地事件记录应放在同一个数据库事务中。只有事务提交成功后,才能认为本次支付结果已经被系统接受。商户通知、积分发放等外部动作不要直接放在事务里同步调用,否则下游超时会拖长锁持有时间,并导致事务回滚后外部动作已经执行。
推荐流程是:事务内条件更新订单、写支付流水、写消息表;事务提交后由消息发布任务异步投递。这样既保持本地数据一致,也为下一课的可靠消息投递建立基础。
验证清单
验证时至少覆盖首次成功、重复成功、关闭后成功和并发成功四种情况。并发测试中应让两个线程同时处理同一订单,最终只能有一个线程更新成功,另一个线程必须识别为幂等结果,而不是再次插入支付流水。
还要检查数据库中同一订单是否只有一条成功流水,以及冲突通知是否产生可检索的告警记录。动态时间和线程执行顺序可能不同,但最终状态必须稳定一致。