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

订单超时关闭

订单超时关闭

本课实现一条可落地的订单超时关闭链路:先识别已过期订单,再通过延迟任务触发渠道关单,最后用状态校正处理“渠道已支付、平台仍待支付”等时间差问题。

学习目标

  • 设计订单过期识别与延迟触发机制
  • 正确处理渠道关单、支付竞态和幂等更新
  • 建立失败重试与状态校正的验收方法

关闭链路与状态边界

订单达到 expireTime 并不代表可以直接改成 CLOSED。平台必须先确认订单仍为待支付状态,再向渠道查询或关单,因为支付成功回调可能与超时任务同时到达。

建议只允许以下核心迁移:PENDING -> SUCCESS、PENDING -> CLOSING、CLOSING -> CLOSED。任何任务都不能把 SUCCESS 反向改为 CLOSED。

订单超时关闭状态与处理链路

过期识别与延迟处理

创建订单时同时保存 expireTime,并投递一条以平台订单号为键的延迟消息。延迟消息只负责触发检查,不携带最终状态;这样即使消息重复投递,也可以通过数据库当前状态保证幂等。

生产环境可使用延迟队列、时间轮或定时扫描。无论采用哪种方式,都应保留定时扫描作为兜底,查询条件至少包含 status = PENDING 与 expire_time <= now(),并限制单批数量。

核心实现

下面给出一个可直接运行的 Java 示例,模拟延迟任务、渠道状态查询、渠道关单和乐观状态更新。真实项目中只需将内存仓库替换为数据库,将 ChannelClient 替换为渠道适配器。

java
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"));
    }
}

预期输出:

text
Order[orderNo=P202608030001, expireTime=2026-08-03T10:00:00Z, status=CLOSED]

实际时间、订单号和渠道响应会不同。示例中的状态条件更新用于表达关键原则:只有当前状态符合预期时才能继续迁移。

失败重试与状态校正

渠道查询超时、关单请求失败或响应不确定时,不应立即标记 CLOSED。平台应保留 CLOSING,记录重试次数和下次执行时间,并对同一渠道请求使用稳定的幂等号。

状态校正任务应再次查询渠道:渠道已支付则修正为 SUCCESS;渠道明确关闭则修正为 CLOSED;状态仍不确定则继续重试并告警。超过最大重试次数后进入人工处理,而不是猜测最终状态。

验收检查

至少验证四类场景:正常超时关闭、支付回调先到、超时任务先到但渠道已支付、渠道关单超时后重试成功。重复消费同一延迟消息时,最终状态必须保持不变,且渠道关单不能产生副作用。

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

目录与阅读设置

阅读设置

17

记录一个想法

订单超时关闭

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

登录哪都通