首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >中小同城外卖SaaS订单状态机设计与幂等防重实战

中小同城外卖SaaS订单状态机设计与幂等防重实战

原创
作者头像
用户12911664
修改于 2026-11-20 13:57:40
修改于 2026-11-20 13:57:40
180
举报

很多同城外卖系统上线后,高频问题集中在:同一个订单多次推送商家、支付回调重复改状态、骑手重复接单、取消订单后退款逻辑错乱。这些问题本质不是并发量多大,而是订单生命周期没有用有限状态机约束、缺少全链路幂等设计。对外卖 SaaS、独立部署的同城外卖平台而言,状态机是订单服务的底座,比单纯堆缓存、加 MQ 更优先。

外卖系统
外卖系统

外卖订单是典型长生命周期业务,横跨用户、支付、商家、骑手、结算 5 个角色,任何回调、推送、定时任务都可能并发修改状态。如果代码里直接写update order set status=xx where id=xx,不加前置条件,一定会出现状态漂移、数据不一致。

一、订单状态枚举与合法流转图

订单正向主链路:待支付 → 已支付(待商家接单) → 商家已接单(备餐) → 待取餐 → 配送中 → 已完成 分支异常链路:待支付→超时取消;已支付→商家拒单 / 用户主动取消;配送中→骑手异常、改派、用户拒收;所有终态:已取消、已退款、已完成,终态禁止任何变更。

核心规则:

  1. 状态流转是有向无环图,禁止任意跳转;已完成订单不能回退到配送中;商家未接单前,不能进入待取餐;
  2. 每一次状态变更,都必须带上前置状态校验条件,数据库 SQL 使用条件更新(乐观锁);
  3. 所有变更记录写入 order_log 表,记录操作人、触发源(支付回调 / 定时任务 / 商家 APP / 骑手端)、旧状态、新状态,作为对账、客诉溯源凭证。

反例:直接根据订单 ID 更新状态,回调重试、网络抖动、MQ 重复消费都会覆盖状态,造成商家收到订单、用户端显示已取消。

二、幂等设计三层落地(SaaS 系统必做)

外卖系统有大量不可靠的回调:微信 / 支付宝支付回调、MQ 消息重复投递、WebSocket 推送失败重试、定时任务重复扫描。幂等不是可选优化,是底线。

  1. 请求层幂等号:前端下单、退款、取消接口必须传入 biz_no,服务端用 Redis 存幂等记录,同一 biz_no 只执行一次业务逻辑;
  2. 数据库条件更新(乐观锁)
代码语言:javascript
复制
UPDATE `order`
SET status = 2, update_time = now()
WHERE id = #{orderId} AND status = 1;

返回影响行数 = 1 才代表更新成功;返回 0 代表状态已经变更,直接丢弃本次请求,不抛异常、不重复执行业务; 3. 消息消费端幂等:MQ 消费时,以 order_id + event_type 作为唯一 key,消费成功写入幂等表;重复消息直接跳过。

误区:很多开发者用版本号 version 做乐观锁。外卖订单场景更推荐状态条件更新,可读性更强,方便业务排查,适合 SaaS 给客户开放后台查看订单日志。

三、超时自动关闭:延迟消息 vs 定时扫描选型

待支付订单超时关闭(15 分钟)、商家接单超时自动取消、骑手长时间未取餐自动改派,是外卖标配能力。

  • 方案 1:定时任务轮询数据库。简单,小流量可用;高峰期扫库压力巨大,容易锁表、延迟不准,不适合 SaaS 多租户;
  • 方案 2:延迟消息(RocketMQ 延迟等级 / RabbitMQ 延迟插件)。下单成功发送一条延迟消息,到期触发关闭逻辑;优势:解耦、不压 DB;注意:消息丢失兜底,需要补偿定时任务,不能完全依赖 MQ;
  • 方案 3:Redis ZSet 延时队列。适合轻量独立部署、不想维护重型 MQ 的客户,适合县城单店、小体量同城外卖。

推荐 SaaS 标准方案:延迟消息为主,低频率补偿扫描兜底。

四、分布式事务简化方案(SaaS 不要硬上 TCC)

外卖下单涉及:扣库存、创建订单、预扣资金、发消息。对中小同城外卖,TCC 太重、运维成本高。 采用本地消息表 + 可靠消息最终一致性:

  1. 事务内:创建订单记录 + 写入本地消息表(待发送);
  2. 独立发送线程轮询本地消息表,投递 MQ;投递成功标记消息已发送;
  3. 消费端:扣商品库存、推送商家、发送延迟消息;消费失败,消息重试;
  4. 对账任务:每日凌晨核对订单、支付、库存差异,人工补偿。

重点:SaaS 面向本地创业者,优先选择可运维、易排查的方案,不追求强一致性,接受短时间最终一致,配套对账补偿。

五、SaaS 多租户隔离下订单状态机坑点

江湖外卖系统支持独立部署、多租户,这里有两个高频踩坑点:

  1. 租户之间订单 ID 冲突:不能只用自增 ID 做主键,或者租户 ID + 订单 ID 联合主键;
  2. 不同商户配置不同超时规则(A 店 10 分钟接单超时、B 店 15 分钟),延迟消息必须携带租户、商户维度配置,不能全局统一超时时间。

FAQ

Q:支付回调来了,订单已经被用户取消怎么办?

A:条件更新失败,进入回调分支,执行退款流程,记录冲突日志。

Q:MQ 重复消费,会不会重复推送商家?

A:幂等控制 + 状态前置校验,状态已经不是待接单,直接跳过推送。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、订单状态枚举与合法流转图
  • 二、幂等设计三层落地(SaaS 系统必做)
  • 三、超时自动关闭:延迟消息 vs 定时扫描选型
  • 四、分布式事务简化方案(SaaS 不要硬上 TCC)
  • 五、SaaS 多租户隔离下订单状态机坑点
  • FAQ
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档