架构与系统设计 / 系统课时
订单状态机
订单状态机
订单状态不能由任意代码随意覆盖,否则重复回调、超时关闭和并发更新会造成状态倒退。本课定义五种核心状态、允许的迁移方向以及数据库更新条件,让每次状态变化都可判断、可审计、可验证。
学习目标
- 明确五种订单状态的业务含义
- 建立合法迁移表并拒绝状态倒退
- 使用条件更新处理并发回调和重复通知
状态定义
PENDING 表示订单已受理但尚未向通道发起支付;PROCESSING 表示请求已提交,最终结果仍不确定;SUCCESS 和 FAILED 表示明确终态;CLOSED 表示订单因过期、撤销或确认取消而结束。
失败订单不建议在原订单上重新进入处理中。需要再次支付时,可以创建新的支付尝试记录,避免同一订单状态来回跳转,导致对账和审计含义不清。

合法迁移规则
状态迁移应由“当前状态、目标状态、业务事件”共同决定,而不是只检查目标值。核心规则如下:
| 当前状态 | 目标状态 | 允许条件 |
|---|---|---|
PENDING |
PROCESSING |
已生成通道请求并准备提交 |
PENDING |
CLOSED |
尚未提交通道且订单过期或主动关闭 |
PROCESSING |
SUCCESS |
收到可信成功结果 |
PROCESSING |
FAILED |
收到明确且不可恢复的失败结果 |
PROCESSING |
CLOSED |
上游已确认取消,不是本地单方面超时 |
SUCCESS、FAILED、CLOSED 都按终态处理。特别是本地查询超时不能直接把 PROCESSING 改成 FAILED,因为通道可能稍后返回成功;结果未知时应保持处理中并继续查询。
用代码固化规则
下面的 Java 示例可直接运行。它把允许关系集中在状态机中,任何业务代码都必须通过 transit 方法迁移:
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());
}
}
}预期输出:
PROCESSING
SUCCESS
非法迁移: SUCCESS -> PROCESSING数据库条件更新
代码层校验只能保护单个线程,数据库还要防止两个回调同时更新。状态更新应携带期望的旧状态和版本号:
UPDATE pay_order
SET status = 'SUCCESS',
version = version + 1,
updated_at = CURRENT_TIMESTAMP
WHERE id = 1001
AND status = 'PROCESSING'
AND version = 3;预期结果:
状态和版本匹配时影响 1 行;任一条件不匹配时影响 0 行。影响零行时不能直接判定失败。应用应重新读取订单:若已是 SUCCESS,说明重复成功回调已经被幂等处理;若是其他终态,则记录状态冲突并进入人工或自动对账。
回调与关闭边界
支付成功回调通常优先级最高,但不能无条件覆盖终态。若订单已关闭后才收到成功通知,应先确认通道是否真实扣款,再通过补单或差错处理流程修正,避免普通更新接口绕过审计。
关闭处理中订单前,必须先获得通道取消确认。仅因本地超时就关闭,会出现“本地已关闭、通道已成功”的双重事实。无法确认最终结果时,应保留 PROCESSING,由查询任务、回调或对账任务继续推进。
每次迁移建议记录事件类型、迁移前后状态、通道流水号、操作来源和时间。状态表负责当前事实,状态日志负责追溯过程,两者职责不要混合。