Wong Kosheng1. 外卖订单状态管理实战：从定时任务到实时提醒
作为一名经历过多个外卖系统开发的老手，我深知订单状态管理是外卖业务的核心痛点。今天要分享的这套解决方案，融合了Spring Task定时任务和WebSocket实时通信技术，完整覆盖了从超时订单处理到来单提醒、客户催单等核心场景。这个方案在我们团队经历了3次迭代优化，目前日均稳定处理10万+订单，可靠性已经得到充分验证。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Spring Task定时任务深度解析
2.1 为什么选择Spring Task？
在Java生态中，Quartz和XXL-Job等分布式任务调度框架确实功能强大，但对于外卖这类中小型系统，Spring Task有着不可替代的优势：
- 零额外依赖：作为Spring框架原生组件，无需引入第三方库
- 注解驱动：通过
@Scheduled注解即可快速定义任务 - 轻量高效：直接使用应用线程池，调度延迟通常在毫秒级
实际踩坑经验：在初期我们尝试过Quartz，发现对于简单的定时任务场景反而增加了复杂度。后来切换到Spring Task后，代码量减少了40%，维护成本大幅降低。
2.2 Cron表达式实战指南
外卖系统中最常用的几个Cron表达式模式：
java复制// 每分钟检查一次超时订单
@Scheduled(cron = "0 * * * * ?")
// 每天凌晨1点处理派送中订单
@Scheduled(cron = "0 0 1 * * ?")
// 每5分钟检查一次库存（扩展场景）
@Scheduled(cron = "0 */5 * * * ?")
Cron表达式常见误区：
*在日和周字段同时使用时可能产生冲突，建议使用?忽略其中一个字段- Spring Task的周字段中1表示周日（与Linux Cron的0不同）
- 月份字段范围是1-12（不是0-11）
2.3 订单状态机设计
在实现定时任务前，需要明确定义订单状态流转：
code复制待支付(1) → 已取消(6)
↘
已支付(2) → 待接单(3) → 已接单(4) → 派送中(5) → 已完成(7)
对应的状态常量建议使用枚举类：
java复制public enum OrderStatus {
PENDING_PAYMENT(1, "待支付"),
PAID(2, "已支付"),
TO_BE_CONFIRMED(3, "待接单"),
CONFIRMED(4, "已接单"),
DELIVERY_IN_PROGRESS(5, "派送中"),
CANCELLED(6, "已取消"),
COMPLETED(7, "已完成");
// 省略构造函数和get方法
}
3. 超时订单处理实现细节
3.1 支付超时处理方案
业务规则：
- 下单后15分钟内未支付自动取消
- 每分钟扫描一次待支付订单
java复制@Scheduled(cron = "0 * * * * ?")
public void processTimeoutOrder() {
LocalDateTime threshold = LocalDateTime.now().minusMinutes(15);
List<Orders> orders = orderMapper.selectByStatusAndTime(
OrderStatus.PENDING_PAYMENT.getValue(),
threshold
);
orders.forEach(order -> {
order.setStatus(OrderStatus.CANCELLED.getValue());
order.setCancelReason("超时未支付");
order.setCancelTime(LocalDateTime.now());
orderMapper.update(order);
// 释放库存等后续操作
inventoryService.release(order.getId());
});
}
性能优化点：
- 使用
LIMIT 100分批处理，避免大事务 - 对
status和create_time建立联合索引 - 添加
@Transactional(propagation = REQUIRES_NEW)避免任务失败影响主事务
3.2 派送超时自动完成
业务规则：
- 每天凌晨1点处理超过24小时未完成的派送中订单
- 防止骑手忘记点击完成影响数据统计
java复制@Scheduled(cron = "0 0 1 * * ?")
public void processDeliveryTimeout() {
LocalDateTime threshold = LocalDateTime.now().minusHours(24);
List<Orders> orders = orderMapper.selectByStatusAndTime(
OrderStatus.DELIVERY_IN_PROGRESS.getValue(),
threshold
);
orders.forEach(order -> {
order.setStatus(OrderStatus.COMPLETED.getValue());
order.setDeliveryTime(LocalDateTime.now());
orderMapper.update(order);
// 触发订单结算流程
settlementService.process(order.getId());
});
}
4. WebSocket实时通信实战
4.1 为什么选择WebSocket？
对比传统轮询方案：
- 减少80%以上的无效请求
- 消息延迟从秒级降到毫秒级
- 服务端可主动推送消息
4.2 服务端核心实现
java复制@ServerEndpoint("/ws/{sid}")
@Component
@Slf4j
public class WebSocketServer {
// 会话存储
private static ConcurrentHashMap<String, Session> sessions = new ConcurrentHashMap<>();
@OnOpen
public void onOpen(Session session, @PathParam("sid") String sid) {
sessions.put(sid, session);
}
@OnClose
public void onClose(@PathParam("sid") String sid) {
sessions.remove(sid);
}
public void sendToAllClient(String message) {
sessions.forEach((sid, session) -> {
try {
session.getBasicRemote().sendText(message);
} catch (IOException e) {
log.error("推送消息失败", e);
}
});
}
}
关键配置项：
yaml复制spring:
websocket:
max-text-message-buffer-size: 512KB
max-session-idle-timeout: 3600000
5. 来单提醒完整实现
5.1 支付成功后的处理链路
java复制public void paySuccess(String outTradeNo) {
// 1. 更新订单状态
Orders order = orderMapper.getByNumber(outTradeNo);
order.setStatus(OrderStatus.TO_BE_CONFIRMED.getValue());
orderMapper.update(order);
// 2. 发送WebSocket通知
Map<String, Object> message = new HashMap<>();
message.put("type", 1); // 1-来单提醒
message.put("orderId", order.getId());
message.put("content", "新订单：" + outTradeNo);
webSocketServer.sendToAllClient(JSON.toJSONString(message));
// 3. 记录通知日志（重要！）
notifyLogService.save(
order.getId(),
NotifyType.ORDER_CREATED,
message
);
}
5.2 前端处理示例
javascript复制const socket = new WebSocket('ws://your-domain.com/ws/1');
socket.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.type === 1) {
// 播放提示音
playSound('/assets/new-order.mp3');
// 显示弹窗
showNotification({
title: '新订单通知',
content: data.content,
duration: 5000
});
}
};
注意事项：
- 添加消息去重机制（相同orderId 5分钟内不重复提醒）
- 准备多套提示音应对不同时段
- 离线消息需要通过轮询补发
6. 客户催单系统设计
6.1 催单业务流程
java复制public void reminder(Long orderId) {
// 1. 校验订单状态
Orders order = orderMapper.getById(orderId);
if (order.getStatus() < OrderStatus.CONFIRMED.getValue()) {
throw new BusinessException("订单尚未接单，不能催单");
}
// 2. 发送催单通知
Map<String, Object> message = new HashMap<>();
message.put("type", 2); // 2-催单提醒
message.put("orderId", orderId);
message.put("content", "订单催单：" + order.getNumber());
webSocketServer.sendToAllClient(JSON.toJSONString(message));
// 3. 更新催单次数
order.setReminderCount(order.getReminderCount() + 1);
orderMapper.update(order);
}
6.2 防骚扰策略
- 单日催单上限3次：
sql复制UPDATE orders SET reminder_count = reminder_count + 1
WHERE id = ? AND reminder_count < 3
- 催单间隔至少10分钟：
java复制LocalDateTime lastReminder = reminderLogService.getLastTime(orderId);
if (lastReminder.plusMinutes(10).isAfter(LocalDateTime.now())) {
throw new BusinessException("操作过于频繁，请稍后再试");
}
7. 生产环境问题排查实录
7.1 定时任务不执行
现象：凌晨的任务偶尔不触发
排查：
- 检查服务器时间同步状态：
ntpstat - 确认Spring Boot启动类有
@EnableScheduling - 检查线程池配置：
yaml复制spring:
task:
scheduling:
pool:
size: 5
thread-name-prefix: my-scheduler-
7.2 WebSocket连接不稳定
优化方案：
- 添加心跳检测（每30秒一次）
- 实现断线重连机制
- 使用STOMP子协议增强可靠性
javascript复制let reconnectAttempts = 0;
const maxReconnectAttempts = 5;
function connect() {
const ws = new WebSocket(endpoint);
ws.onclose = () => {
if (reconnectAttempts < maxReconnectAttempts) {
setTimeout(() => {
reconnectAttempts++;
connect();
}, 1000 * Math.pow(2, reconnectAttempts));
}
};
}
这套系统经过我们团队两年多的迭代优化，目前已经形成了一套标准化的外卖订单管理解决方案。其中最重要的经验是：定时任务的执行时间要避开业务高峰，WebSocket消息一定要有确认机制。对于中小型外卖平台，这个方案完全能够满足需求，日均万级订单量下运行稳定。