反向海淘订单状态机设计：taocarts 状态流转与并发控制

订单是反向海淘的核心载体，状态复杂、分支多、并发风险高。taocarts 设计了单向、闭环、带锁的订单状态机，有效避免状态错乱、重复采购、超卖、对账混乱。本文详细拆解状态定义、流转规则、并发控制、快照机制，并附代码示例。

一、反向海淘订单状态定义

taocarts 标准主状态：

复制代码

待付款 → 待采购 → 采购中 → 已采购 → 待入库 → 已入库 → 待合箱 → 已合箱 → 出库转运 → 国际运输 → 派送中 → 已完成

异常分支：

待付款 → 已取消；
采购中 → 采购失败；
已入库 → 退货 / 理赔；
国际运输 → 丢件 / 清关滞留。

二、状态流转核心规则

单向不可逆：不能从 "已采购" 退回 "待采购"；
状态锁：进入某状态后，锁定操作权限，防止并发修改；
事件驱动：状态变更由明确事件触发（支付成功、采购回调、入库扫码）。

三、并发控制：分布式锁 + 状态校验

高并发下，同一订单可能被多次触发采购，导致重复下单、资金损失。taocarts 采用：

Redis 分布式锁：同一订单同一时间只允许一次采购；
状态前置校验：只有 "待采购" 才能触发采购；
数据库事务：状态更新与业务操作原子执行。

四、订单快照机制

下单瞬间，快照所有关键数据：

商品标题、SKU、价格、图片；
汇率、运费、用户地址；
支付方式、时间。

后续原平台变动，不影响已下单订单，售后以快照为准。

五、代码示例：订单状态流转（PHP/Laravel）

复制代码

<?php
namespace App\Services\Order;
use App\Models\Order;
use Illuminate\Support\Facades\Redis;

class OrderStateService
{
    // 状态常量
    const STATUS_PENDING_PAY = 1;
    const STATUS_PENDING_PROCURE = 2;
    const STATUS_PROCUREING = 3;
    const STATUS_PROCURED = 4;

    // 触发采购
    public function triggerProcure($orderId)
    {
        $lockKey = "order:lock:{$orderId}";
        // 分布式锁，防止并发
        if (!Redis::set($lockKey, '1', 'NX', 30)) {
            return ['code' => -1, 'msg' => '操作频繁，请稍后重试'];
        }

        try {
            $order = Order::findOrFail($orderId);
            // 状态校验：必须是待采购
            if ($order->status != self::STATUS_PENDING_PROCURE) {
                return ['code' => -2, 'msg' => '订单状态不允许采购'];
            }

            // 更新为采购中
            $order->status = self::STATUS_PROCUREING;
            $order->procure_start_at = now();
            $order->save();

            // 异步调用采购服务（此处省略）
            // ...

            return ['code' => 0, 'msg' => '采购已触发'];
        } finally {
            Redis::del($lockKey);
        }
    }
}

六、总结

订单状态机是反向海淘系统的心脏。taocarts 通过单向流转、状态锁、分布式事务、快照机制 ，把复杂的订单流程变成可控、可追溯、可容错的标准化流程，为规模化运营打下坚实基础。