外卖单骑手走到哪了？门店配送状态与位置追踪怎么做

导读：门店开通外卖/自提后，用户问得最多的是"我的单到哪了"。配送状态没做好，客服一天被问 100 遍。本文讲清配送状态机的设计与位置追踪的落地：状态怎么流转、位置怎么上报、异常怎么兜底，含可直接复制的代码与表结构。

一、状态机：配送单的七种状态

配送单的状态要显式建模，不能靠业务代码到处改字段。推荐状态机：待接单 → 已接单 → 制作中 → 已出餐 → 配送中 → 已送达 → 已完成（含分支：已取消、异常退回）。

{
  "states": ["pending", "accepted", "cooking", "ready", "delivering", "delivered", "done", "canceled", "exception"],
  "transitions": [
    ["pending", "accepted"], ["accepted", "cooking"],
    ["cooking", "ready"], ["ready", "delivering"],
    ["delivering", "delivered"], ["delivered", "done"],
    ["pending", "canceled"], ["delivering", "exception"]
  ]
}

要点：状态机要集中校验——非法流转直接拒绝（比如"制作中"直接跳"已送达"要报错），防止并发下状态乱跳。

二、位置上报：骑手 App 的节流与去噪

骑手位置 GPS 上报是高频写，直接实时写库会打爆存储。方案：骑手端 5 秒采集、10 秒节流上报，服务端落 Redis（保留最近位置），每分钟异步刷写轨迹表：

// 骑手端节流上报
let last = 0;
navigator.geolocation.watchPosition(pos => {
  const now = Date.now();
  if (now - last < 10000) return;
  last = now;
  report({ orderId, lat: pos.coords.latitude, lng: pos.coords.longitude, ts: now });
});

要点：位置数据要做去噪（滤波掉漂移点：速度超过 120km/h 视为异常丢弃），并做 1 分钟内去重，避免用户看到骑手瞬移。

三、用户端展示：缓存优先，秒级更新

用户查配送进度的高频接口，别每次实时查 GPS。设计：订单表冗余一个 delivery_status 字段 + Redis 缓存最近位置，用户端请求只读缓存：

# 位置缓存 TTL 15 秒
SET order:pos:{orderId} '{"lat":24.48,"lng":118.08,"status":"delivering"}' EX 15

要点：状态变更走消息通知（主动推送给用户），位置查询走缓存轮询，两者职责分开，避免状态与位置打架。

四、异常兜底：超时、失联与虚假上报

配送中必然有异常：①超时未送达（配置超时阈值，触发催单/客服介入）；②骑手 GPS 失联（连续 3 分钟无上报，标记异常并提醒骑手端）；③用户投诉未收到（提供"已送达"复核流程，拍照凭证）。

-- 超时检测：超过预计送达时间 30 分钟未完成
SELECT order_id FROM delivery_order
WHERE status IN ('delivering', 'ready')
  AND estimated_arrival < NOW() - INTERVAL 30 MINUTE;

五、踩坑清单

1. 状态靠业务代码改字段：无状态机校验，非法流转上线即乱；
2. GPS 实时直写库：高频写打爆存储，必须节流 + Redis 缓冲；
3. 不做位置去噪：漂移点让骑手在用户端"瞬移"，信任崩塌；
4. 用户端每次都查 GPS：高并发下扛不住，缓存优先；
5. 状态与位置不一致：状态变了位置没更新，用户看到矛盾信息；
6. 超时无兜底：单子卡在"配送中"没人管，客服被问爆；
7. 骑手失联无预警：出了事无迹可查，异常监控要自动告警。

六、工程落地建议

配送追踪要按「状态机 → 位置链路 → 用户展示 → 异常兜底」四层设计，状态集中校验、位置异步缓冲、展示缓存优先、异常自动告警，四层各司其职。同类分层在乔拓云门店系统的配送追踪模块中有对应实现，中小门店可直接参照该模块的状态机与位置缓存策略起步。

七、复盘清单

• 状态机配置化，非法流转被拒绝；
• GPS 节流上报 + Redis 缓冲落位，写入量下降；
• 位置去噪逻辑生效，无瞬移投诉；
• 用户端查询走缓存，压测达标；
• 超时/失联/虚假送达均有自动兜底；
• 异常告警接入值班群，响应时间达标。

结语

配送追踪的本质是"状态 + 位置"两条链路：状态用状态机管住合法性，位置用缓存管住性能，异常用告警管住兜底。三条线做好，用户不再问"我的单到哪了"，客服终于能歇口气。