首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政上门预约业务开发:双端订单消息同步与状态推送方案

家政上门预约业务开发:双端订单消息同步与状态推送方案

原创
作者头像
芮安科技
发布于 2026-11-18 14:16:14
发布于 2026-11-18 14:16:14
510
举报

家政上门预约业务开发:双端订单消息同步与状态推送方案

在家政上门预约场景,订单状态会经历下单、派单、技师接单、改期、完工、取消等多个节点。用户在小程序、H5之间切换访问时,如果消息推送机制设计不合理,容易出现一端收到订单通知、另一端状态滞后,甚至订单状态长期不更新的问题。本文基于SpringBoot结合消息队列、WebSocket,搭建适配小程序和H5的订单消息同步方案,兼顾在线实时推送与离线消息触达,保障双端订单状态一致性。

一、双端订单消息推送的业务痛点

小程序和H5的消息触达能力存在天然差异。小程序支持微信订阅消息,H5没有原生订阅通知能力,只能依靠站内消息、浏览器通知。如果推送逻辑没有统一抽象,会出现通知渠道硬编码、业务代码臃肿。 当用户同时在小程序、H5保持在线,订单变更后只推送到其中一端,就会造成状态不同步;WebSocket断连、网络抖动会导致消息丢失;如果没有消息持久化和重试机制,离线用户无法感知订单变化。同时,大量订单集中变更时,直接循环推送容易引发接口限流、服务压力突增。

二、整体方案架构设计

方案采用事件驱动的模式,订单状态变更作为事件源,消息队列实现异步解耦。 订单服务完成订单状态变更、数据库写入之后,向消息队列投递订单变更事件。消息消费端分为两个分支:一路推送到WebSocket服务,查询该用户所有在线会话,实时推送订单变更报文;另一路写入站内消息表,作为离线兜底。Redis用于存储用户在线会话映射、消息去重标识,避免重复推送。 推送层抽象推送接口,适配不同渠道:小程序走订阅消息、H5走站内消息+浏览器通知,业务层无需关心渠道差异。

三、订单事件与消息去重设计

每一条订单变更事件携带唯一的eventId,用于幂等控制。消息队列消费时,先查询Redis判断该eventId是否已经处理成功,防止消息重复消费带来重复推送。 事件报文统一字段:订单ID、用户ID、订单状态、变更类型、变更时间、版本号。前端收到推送报文后,对比本地缓存的订单版本号,版本更大才更新页面数据,忽略旧消息。 核心Java代码示例:

代码语言:javascript
复制
@Service
public class OrderMessagePushService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private RocketMQTemplate rocketMQTemplate;
    private static final String MSG_DUPLICATE_KEY = "house:msg:duplicate:";

    public void publishOrderEvent(OrderEvent event) {
        //投递订单变更事件
        rocketMQTemplate.convertAndSend("order-event-topic", event);
    }

    @RocketMQMessageListener(topic = "order-event-topic", consumerGroup = "order-push-group")
    public class OrderEventConsumer implements RocketMQListener<OrderEvent> {
        @Autowired
        private WebSocketPushService webSocketPushService;
        @Autowired
        private InnerMessageService innerMessageService;

        @Override
        public void onMessage(OrderEvent event) {
            String duplicateKey = MSG_DUPLICATE_KEY + event.getEventId();
            Boolean exist = redisTemplate.hasKey(duplicateKey);
            if(Boolean.TRUE.equals(exist)){
                return;
            }
            //在线实时推送
            webSocketPushService.pushToUser(event.getUserId(), event);
            //写入离线站内消息
            innerMessageService.saveInnerMsg(event);
            redisTemplate.opsForValue().set(duplicateKey, "1", 1, TimeUnit.HOURS);
        }
    }
}

四、WebSocket长连接管理

WebSocket服务维护userId和sessionId的映射关系,一个用户可以绑定多条session,对应小程序、H5多个终端同时在线。 用户打开订单页面时建立连接,页面关闭、长时间无心跳则断开连接,清理Redis会话映射。推送时根据userId批量获取全部会话,向所有终端推送同一份订单变更数据,保证小程序、H5同时收到更新。 长连接增加心跳检测,自动清理僵尸连接,避免无效连接堆积占用资源。

五、离线消息与渠道差异化处理

WebSocket不在线时,消息存入站内消息表。用户下次打开小程序或者H5,前端主动拉取未读消息列表,同步更新订单状态。 渠道差异化处理封装在推送适配器中: 小程序渠道:满足订阅消息模板条件时,调用微信订阅消息接口; H5渠道:优先存入站内消息,支持浏览器Notification通知; 适配器统一返回推送结果,记录推送日志,推送失败的消息加入重试队列,设置最大重试次数。

六、前端消息接收与状态更新逻辑

前端封装统一消息接收工具,WebSocket收到消息后,触发订单更新回调。 小程序端存储订单缓存到storage,H5存储到localStorage。收到推送后,对比本地订单版本,版本号落后则请求接口拉取最新订单详情,覆盖本地缓存。 同时增加兜底策略:用户每次进入订单列表页,主动拉取一次订单数据,防止WebSocket消息丢失导致状态停滞。

七、监控、告警与限流策略

监控指标包含消息堆积量、WebSocket在线连接数、推送成功率、重试次数。推送失败率超过阈值触发告警。 针对微信订阅消息、浏览器通知接口增加限流配置,避免短时间大量推送触发平台风控。消息消费端设置并发数,控制推送并发压力。所有推送记录入库,支持按订单、用户、渠道查询推送日志,方便问题排查。

八、测试验证场景

测试场景包含:小程序下单,H5在线实时收到状态推送;H5修改预约,小程序同步更新;用户全部离线,再次打开任意一端都能加载离线消息;网络中断重连后,消息正常接收;重复投递消息,验证幂等去重逻辑。

总结

这套双端订单消息同步方案,以事件驱动为核心,通过消息队列异步解耦、WebSocket实现在线实时推送、站内消息作为离线兜底,同时利用适配器隔离小程序和H5的通知渠道差异。依靠eventId实现消息幂等,订单版本号保证前端状态更新的正确性,解决了家政订单跨终端消息不同步的问题。该方案可以平滑扩展到技师端APP、管理后台,统一整套订单消息推送体系。落地时重点做好长连接心跳维护、消息重试策略、第三方通知接口限流,在消息实时性和服务稳定性之间做好平衡。

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

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

目录
  • 家政上门预约业务开发:双端订单消息同步与状态推送方案
    • 一、双端订单消息推送的业务痛点
    • 二、整体方案架构设计
    • 三、订单事件与消息去重设计
    • 四、WebSocket长连接管理
    • 五、离线消息与渠道差异化处理
    • 六、前端消息接收与状态更新逻辑
    • 七、监控、告警与限流策略
    • 八、测试验证场景
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档