反向海淘订单状态机设计:taocarts 状态流转与并发控制
订单是反向海淘的核心载体,状态复杂、分支多、并发风险高。taocarts 设计了
单向、闭环、带锁
的订单状态机,有效避免状态错乱、重复采购、超卖、对账混乱。本文详细拆解状态定义、流转规则、并发控制、快照机制,并附代码示例。
一、反向海淘订单状态定义
taocarts 标准主状态:
待付款 → 待采购 → 采购中 → 已采购 → 待入库 → 已入库 → 待合箱 → 已合箱 → 出库转运 → 国际运输 → 派送中 → 已完成
异常分支:
待付款 → 已取消;
采购中 → 采购失败;
已入库 → 退货 / 理赔;
国际运输 → 丢件 / 清关滞留。
二、状态流转核心规则
单向不可逆
:不能从 “已采购” 退回 “待采购”;
状态锁
:进入某状态后,锁定操作权限,防止并发修改;
事件驱动
:状态变更由明确事件触发(支付成功、采购回调、入库扫码)。
三、并发控制:分布式锁 + 状态校验
高并发下,同一订单可能被多次触发采购,导致
重复下单、资金损失
。taocarts 采用:
Redis 分布式锁
:同一订单同一时间只允许一次采购;
状态前置校验
:只有 “待采购” 才能触发采购;
数据库事务
:状态更新与业务操作原子执行。
四、订单快照机制
下单瞬间,
快照所有关键数据
:
商品标题、SKU、价格、图片;
汇率、运费、用户地址;
支付方式、时间。
后续原平台变动,不影响已下单订单,售后以快照为准。
五、代码示例:订单状态流转(PHP/Laravel)
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 通过
单向流转、状态锁、分布式事务、快照机制
,把复杂的订单流程变成
可控、可追溯、可容错
的标准化流程,为规模化运营打下坚实基础。