架构与系统设计 / 系统课时
订单超时关闭
订单超时关闭
本课实现一条可落地的订单超时关闭链路:先识别已过期订单,再通过延迟任务触发渠道关单,最后用状态校正处理“渠道已支付、平台仍待支付”等时间差问题。
学习目标
- 设计订单过期识别与延迟触发机制
- 正确处理渠道关单、支付竞态和幂等更新
- 建立失败重试与状态校正的验收方法
关闭链路与状态边界
订单达到 expireTime 并不代表可以直接改成 CLOSED。平台必须先确认订单仍为待支付状态,再向渠道查询或关单,因为支付成功回调可能与超时任务同时到达。
建议只允许以下核心迁移:PENDING -> SUCCESS、PENDING -> CLOSING、CLOSING -> CLOSED。任何任务都不能把 SUCCESS 反向改为 CLOSED。

过期识别与延迟处理
创建订单时同时保存 expireTime,并投递一条以平台订单号为键的延迟消息。延迟消息只负责触发检查,不携带最终状态;这样即使消息重复投递,也可以通过数据库当前状态保证幂等。
生产环境可使用延迟队列、时间轮或定时扫描。无论采用哪种方式,都应保留定时扫描作为兜底,查询条件至少包含 status = PENDING 与 expire_time <= now(),并限制单批数量。
核心实现
下面给出一个可直接运行的 Java 示例,模拟延迟任务、渠道状态查询、渠道关单和乐观状态更新。真实项目中只需将内存仓库替换为数据库,将 ChannelClient 替换为渠道适配器。
import java.time.Instant;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
public class OrderTimeoutDemo {
enum Status { PENDING, CLOSING, CLOSED, SUCCESS }
enum ChannelStatus { NOT_PAY, PAID, CLOSED }
record Order(String orderNo, Instant expireTime, Status status) {
Order withStatus(Status next) {
return new Order(orderNo, expireTime, next);
}
}
static class OrderRepository {
private final Map<String, Order> data = new ConcurrentHashMap<>();
void save(Order order) {
data.put(order.orderNo(), order);
}
Order find(String orderNo) {
return data.get(orderNo);
}
synchronized boolean changeStatus(String orderNo, Status expected, Status next) {
Order current = data.get(orderNo);
if (current == null || current.status() != expected) {
return false;
}
data.put(orderNo, current.withStatus(next));
return true;
}
}
static class ChannelClient {
ChannelStatus query(String orderNo) {
return ChannelStatus.NOT_PAY;
}
boolean close(String orderNo) {
return true;
}
}
static class TimeoutService {
private final OrderRepository repository;
private final ChannelClient channelClient;
TimeoutService(OrderRepository repository, ChannelClient channelClient) {
this.repository = repository;
this.channelClient = channelClient;
}
void handle(String orderNo, Instant now) {
Order order = repository.find(orderNo);
if (order == null || order.status() != Status.PENDING || now.isBefore(order.expireTime())) {
return;
}
ChannelStatus channelStatus = channelClient.query(orderNo);
if (channelStatus == ChannelStatus.PAID) {
repository.changeStatus(orderNo, Status.PENDING, Status.SUCCESS);
return;
}
if (!repository.changeStatus(orderNo, Status.PENDING, Status.CLOSING)) {
return; // 支付回调已抢先更新时,停止关单
}
if (channelClient.close(orderNo)) {
repository.changeStatus(orderNo, Status.CLOSING, Status.CLOSED);
}
}
}
public static void main(String[] args) {
OrderRepository repository = new OrderRepository();
repository.save(new Order("P202608030001", Instant.parse("2026-08-03T10:00:00Z"), Status.PENDING));
new TimeoutService(repository, new ChannelClient())
.handle("P202608030001", Instant.parse("2026-08-03T10:05:00Z"));
System.out.println(repository.find("P202608030001"));
}
}预期输出:
Order[orderNo=P202608030001, expireTime=2026-08-03T10:00:00Z, status=CLOSED]实际时间、订单号和渠道响应会不同。示例中的状态条件更新用于表达关键原则:只有当前状态符合预期时才能继续迁移。
失败重试与状态校正
渠道查询超时、关单请求失败或响应不确定时,不应立即标记 CLOSED。平台应保留 CLOSING,记录重试次数和下次执行时间,并对同一渠道请求使用稳定的幂等号。
状态校正任务应再次查询渠道:渠道已支付则修正为 SUCCESS;渠道明确关闭则修正为 CLOSED;状态仍不确定则继续重试并告警。超过最大重试次数后进入人工处理,而不是猜测最终状态。
验收检查
至少验证四类场景:正常超时关闭、支付回调先到、超时任务先到但渠道已支付、渠道关单超时后重试成功。重复消费同一延迟消息时,最终状态必须保持不变,且渠道关单不能产生副作用。