在家政上门履约场景中,用户可以通过H5分享链接或者小程序下单,师傅则使用小程序或者H5工单页面接单、更新履约状态。多端协同的核心难点是:用户端与师傅端订单状态实时对齐、权限隔离、消息定向推送,同时兼容小程序和H5两者能力差异。本文基于SpringBoot+WebSocket+消息队列,介绍一套用户、师傅多端协同的实现方案,保证下单、派单、签到、完工全链路状态互通。

项目初期各端独立开发,出现了几类典型协同问题。 第一,状态不同步:师傅在师傅端小程序更新接单状态,用户H5页面没有及时刷新,用户误以为订单无人处理;第二,消息触达不一致,小程序支持微信订阅消息,H5仅支持站内消息,离线场景容易丢失通知;第三,角色权限管控混乱,师傅端接口和用户端接口没有隔离,存在越权查看他人工单的风险;第四,部分师傅设备环境限制,无法安装小程序,只能使用H5接单,两套端的工单操作逻辑不一致,容易出现状态机流转异常。 单纯依靠前端轮询刷新,会带来服务压力大、延迟高的问题,需要统一后端协同能力,对前端只做适配层处理。
方案采用统一后端服务 + 多端适配层的架构,订单中心作为唯一数据源,所有用户端、师傅端的小程序、H5请求,统一接入网关。 网关层做身份和角色鉴权,区分用户角色和师傅角色;订单中心维护订单状态机,控制订单合法流转;派单引擎负责匹配师傅、生成工单;WebSocket负责在线实时推送,消息队列处理离线消息、订阅消息异步下发;Redis存储师傅在线状态、地理位置、工单缓存。 前端侧,用户端H5、用户小程序、师傅H5、师傅小程序共用同一套API,只根据端的能力差异做交互适配,不改动业务规则。

登录时区分用户身份类型,后端通过身份标识控制接口访问范围。普通用户只能查看自己提交的订单;师傅只能查看分配给自己的工单,不能查看平台其他师傅工单。 每一次工单操作,都携带身份信息,后端校验订单归属关系,防止越权操作。
@Service
public class OrderSyncService {
@Autowired
private StringRedisTemplate redisTemplate;
@Autowired
private WebSocketPushService webSocketPushService;
@Autowired
private RocketMQTemplate rocketMQTemplate;
private static final String ORDER_STATUS_KEY = "house:order:status:";
public ResultDTO<String> updateOrderStatus(OrderStatusDTO dto) {
// 权限校验:判断操作者是否为订单所属师傅
OrderInfo order = orderMapper.selectById(dto.getOrderId());
if (!order.getStaffId().equals(dto.getOperatorId())) {
return ResultDTO.fail("无权限操作该工单");
}
// 状态机校验,判断是否允许流转
boolean canChange = orderStateMachine.checkState(order.getStatus(), dto.getNewStatus());
if (!canChange) {
return ResultDTO.fail("当前订单状态不支持该操作");
}
// 更新数据库与缓存
order.setStatus(dto.getNewStatus());
order.setOperateTime(LocalDateTime.now());
orderMapper.updateById(order);
redisTemplate.opsForValue().set(ORDER_STATUS_KEY + dto.getOrderId(), dto.getNewStatus(), 3, TimeUnit.DAYS);
// 构建事件,推送用户端和师傅端
OrderStatusEvent event = new OrderStatusEvent();
event.setOrderId(dto.getOrderId());
event.setUserId(order.getUserId());
event.setStaffId(order.getStaffId());
event.setNewStatus(dto.getNewStatus());
rocketMQTemplate.convertAndSend("order-status-event-topic", event);
webSocketPushService.pushOrderEvent(event);
return ResultDTO.success("状态更新成功");
}
}WebSocket服务维护两类连接映射:userId和session集合、staffId和session集合。当师傅更新订单状态,推送服务同时向该用户所有在线终端(用户小程序、用户H5)推送变更事件;也向该师傅的所有在线终端(师傅小程序、师傅H5)同步最新工单信息。 增加心跳检测,定时清理离线连接,Redis记录师傅在线状态,派单引擎优先推送给在线师傅。 WebSocket作为实时通道,离线用户、师傅的消息存入站内消息表,下次打开页面自动拉取,和订阅消息形成互补。
派单引擎根据服务品类、地理位置、师傅负载、评分筛选候选师傅,支持自动派单和抢单两种模式。 工单消息下发后,师傅无论是小程序还是H5打开,展示的工单信息、接单/拒单按钮、校验规则完全一致。师傅接单操作成功后,订单状态变更,立刻推送通知给对应用户。 同时增加接单超时机制,超过指定时长未接单,系统自动回收工单,重新进入派单池,并且推送超时提醒。
前端基于UniApp实现,用户端、师傅端分为两个项目,同时编译输出小程序包和H5资源。
网络异常场景:前端提交操作失败时,在本地缓存操作记录,网络恢复后重试,后端依靠幂等号防止重复操作。 监控指标包含:WebSocket在线连接数、订单状态变更QPS、消息推送成功率、接单超时数量。推送失败的消息进入死信队列,后台可查看记录。 兜底方案:WebSocket连接断开时,前端开启低频率轮询作为降级方案,保证弱网环境下用户和师傅可以看到最新订单状态。
测试场景:用户H5下单,师傅小程序收到工单;师傅H5接单,用户小程序收到状态更新;师傅拒单,订单重新派单;离线后再次打开,可收到离线消息;跨角色越权操作被拦截;订单状态非法流转被状态机拦截。

这套多端协同方案,核心是订单中心作为单一可信数据源,通过状态机管控订单履约流程,WebSocket+消息队列实现用户端、师傅端小程序和H5的双向实时同步,网关层做好角色权限隔离。前端只针对平台能力差异做适配,业务逻辑收敛在后端,避免多端规则不一致。该方案可以和前面的跨端登录、草稿购物车、并发预约模块组合,形成完整家政预约平台。落地时重点做好消息定向推送、状态机校验、师傅在线状态维护,在实时性和系统稳定性之间做好平衡。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。