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

订单状态机

订单状态机

订单状态不能由任意代码随意覆盖,否则重复回调、超时关闭和并发更新会造成状态倒退。本课定义五种核心状态、允许的迁移方向以及数据库更新条件,让每次状态变化都可判断、可审计、可验证。

学习目标

  • 明确五种订单状态的业务含义
  • 建立合法迁移表并拒绝状态倒退
  • 使用条件更新处理并发回调和重复通知

状态定义

PENDING 表示订单已受理但尚未向通道发起支付;PROCESSING 表示请求已提交,最终结果仍不确定;SUCCESS 和 FAILED 表示明确终态;CLOSED 表示订单因过期、撤销或确认取消而结束。

失败订单不建议在原订单上重新进入处理中。需要再次支付时,可以创建新的支付尝试记录,避免同一订单状态来回跳转,导致对账和审计含义不清。

订单状态机

合法迁移规则

状态迁移应由“当前状态、目标状态、业务事件”共同决定,而不是只检查目标值。核心规则如下:

当前状态 目标状态 允许条件
PENDING PROCESSING 已生成通道请求并准备提交
PENDING CLOSED 尚未提交通道且订单过期或主动关闭
PROCESSING SUCCESS 收到可信成功结果
PROCESSING FAILED 收到明确且不可恢复的失败结果
PROCESSING CLOSED 上游已确认取消,不是本地单方面超时

SUCCESS、FAILED、CLOSED 都按终态处理。特别是本地查询超时不能直接把 PROCESSING 改成 FAILED,因为通道可能稍后返回成功;结果未知时应保持处理中并继续查询。

用代码固化规则

下面的 Java 示例可直接运行。它把允许关系集中在状态机中,任何业务代码都必须通过 transit 方法迁移:

java
import java.util.EnumMap;
import java.util.EnumSet;
import java.util.Map;
import java.util.Set;

public class OrderStateMachineDemo {

    enum OrderStatus {
        PENDING, PROCESSING, SUCCESS, FAILED, CLOSED
    }

    private static final Map<OrderStatus, Set<OrderStatus>> TRANSITIONS =
            new EnumMap<>(OrderStatus.class);

    static {
        TRANSITIONS.put(OrderStatus.PENDING,
                EnumSet.of(OrderStatus.PROCESSING, OrderStatus.CLOSED));
        TRANSITIONS.put(OrderStatus.PROCESSING,
                EnumSet.of(OrderStatus.SUCCESS, OrderStatus.FAILED, OrderStatus.CLOSED));
        TRANSITIONS.put(OrderStatus.SUCCESS, EnumSet.noneOf(OrderStatus.class));
        TRANSITIONS.put(OrderStatus.FAILED, EnumSet.noneOf(OrderStatus.class));
        TRANSITIONS.put(OrderStatus.CLOSED, EnumSet.noneOf(OrderStatus.class));
    }

    static OrderStatus transit(OrderStatus current, OrderStatus target) {
        // 所有迁移统一从白名单判断,避免分散的 if 修改规则
        if (!TRANSITIONS.get(current).contains(target)) {
            throw new IllegalStateException(
                    "非法迁移: " + current + " -> " + target);
        }
        return target;
    }

    public static void main(String[] args) {
        OrderStatus status = transit(OrderStatus.PENDING, OrderStatus.PROCESSING);
        System.out.println(status);

        status = transit(status, OrderStatus.SUCCESS);
        System.out.println(status);

        try {
            transit(status, OrderStatus.PROCESSING);
        } catch (IllegalStateException ex) {
            System.out.println(ex.getMessage());
        }
    }
}

预期输出:

text
PROCESSING
SUCCESS
非法迁移: SUCCESS -> PROCESSING

数据库条件更新

代码层校验只能保护单个线程,数据库还要防止两个回调同时更新。状态更新应携带期望的旧状态和版本号:

sql
UPDATE pay_order
SET status = 'SUCCESS',
    version = version + 1,
    updated_at = CURRENT_TIMESTAMP
WHERE id = 1001
  AND status = 'PROCESSING'
  AND version = 3;

预期结果:

text
状态和版本匹配时影响 1 行;任一条件不匹配时影响 0 行。

影响零行时不能直接判定失败。应用应重新读取订单:若已是 SUCCESS,说明重复成功回调已经被幂等处理;若是其他终态,则记录状态冲突并进入人工或自动对账。

回调与关闭边界

支付成功回调通常优先级最高,但不能无条件覆盖终态。若订单已关闭后才收到成功通知,应先确认通道是否真实扣款,再通过补单或差错处理流程修正,避免普通更新接口绕过审计。

关闭处理中订单前,必须先获得通道取消确认。仅因本地超时就关闭,会出现“本地已关闭、通道已成功”的双重事实。无法确认最终结果时,应保留 PROCESSING,由查询任务、回调或对账任务继续推进。

每次迁移建议记录事件类型、迁移前后状态、通道流水号、操作来源和时间。状态表负责当前事实,状态日志负责追溯过程,两者职责不要混合。

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

目录与阅读设置

阅读设置

17

记录一个想法

订单状态机

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

登录哪都通