架构与系统设计 / 系统课时

支付结果更新

支付结果更新

支付回调可能重复、乱序甚至并发到达,本课将把“收到成功通知就直接改状态”改造成可校验、可重入、可追踪的状态推进流程,最终实现订单只从合法前置状态更新到目标状态,并能安全处理重复通知和冲突结果。

学习目标

  • 理解支付订单状态推进必须同时校验当前状态与目标状态
  • 使用条件更新避免并发回调覆盖已确定的支付结果
  • 通过更新结果和订单快照区分成功、重复与冲突通知

为什么不能直接覆盖状态

支付平台通常会同时接收渠道异步通知、主动查询结果和内部补偿任务。它们可能针对同一订单并发执行。若代码只按订单号执行 UPDATE pay_order SET status = 'SUCCESS',较晚到达的请求就可能覆盖已经关闭、退款或失败的订单。

安全更新的核心不是“把状态改成什么”,而是“只有当前状态仍满足前置条件时才允许修改”。例如支付成功只能由 PAYING 推进到 SUCCESS;重复的成功通知不需要再次写库;关闭后的成功通知则应记录为冲突并进入人工或补偿处理。

支付订单状态推进示意图

使用条件更新推进状态

下面的 SQL 片段由仓储层绑定参数,只允许 PAYING 状态的订单更新为成功,同时写入渠道流水号和支付时间。version 用于保留乐观锁语义,updated_at 便于审计。

sql
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 行。

text
首次成功通知:Affected rows: 1
重复成功通知:Affected rows: 0
状态冲突通知:Affected rows: 0

仅凭“影响 0 行”还不能判断具体原因,因此服务层必须重新读取订单快照。若当前已经是 SUCCESS,且渠道流水号一致,应返回幂等成功;若状态为 CLOSED、FAILED,或渠道流水号不一致,则应记录冲突。

在服务层区分三类结果

下面是服务层片段示例,依赖仓储接口的数据库实现。仓储接口负责执行条件更新和查询订单,服务根据更新行数与最新状态返回明确结果。

java
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。

text
UPDATED
IDEMPOTENT
NOT_FOUND
CONFLICT

实际项目中,CONFLICT 不应只写普通日志。建议记录订单号、当前状态、目标状态、渠道流水号和通知来源,并发送到告警或补偿队列,避免真正的支付成功被静默丢弃。

事务与后续动作边界

订单状态更新、支付流水写入和本地事件记录应放在同一个数据库事务中。只有事务提交成功后,才能认为本次支付结果已经被系统接受。商户通知、积分发放等外部动作不要直接放在事务里同步调用,否则下游超时会拖长锁持有时间,并导致事务回滚后外部动作已经执行。

推荐流程是:事务内条件更新订单、写支付流水、写消息表;事务提交后由消息发布任务异步投递。这样既保持本地数据一致,也为下一课的可靠消息投递建立基础。

验证清单

验证时至少覆盖首次成功、重复成功、关闭后成功和并发成功四种情况。并发测试中应让两个线程同时处理同一订单,最终只能有一个线程更新成功,另一个线程必须识别为幂等结果,而不是再次插入支付流水。

还要检查数据库中同一订单是否只有一条成功流水,以及冲突通知是否产生可检索的告警记录。动态时间和线程执行顺序可能不同,但最终状态必须稳定一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

支付结果更新

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

登录哪都通