同城家政上门预约平台开发:小程序H5订单实时同步设计
同城家政预约业务中,用户经常会在微信小程序下单,之后通过H5分享链接查看订单、修改预约时间、取消服务;技师与管理员也需要在不同终端看到一致的订单状态。如果小程序、H5各自维护数据,很容易出现订单状态不同步、档期重复锁定、用户操作互相覆盖等问题。本文围绕SpringBoot后端,讲解一套适合家政预约场景的订单实时同步方案,解决多端数据一致性、实时推送、并发冲突的问题。
一、业务场景与同步难点
家政订单的履约链路较长,包含下单、改期、取消、派单、技师接单、上门完成等多个状态节点。小程序和H5底层能力差异明显:小程序支持微信订阅消息,H5依赖浏览器通知;两者本地存储载体不同,小程序使用storage,H5使用localStorage。
如果采用轮询方案,实时性差,服务端查询压力大;如果没有并发控制,同一账号在小程序和H5同时修改订单,会发生数据覆盖。同时网络抖动、消息丢失,会造成一端订单状态更新,另一端一直是旧数据,影响用户履约体验。
二、整体同步架构设计
方案采用统一数据源+事件驱动的架构,小程序、H5只是前端接入入口,不独立存储业务订单数据。所有请求统一接入API网关,经过身份校验后进入订单业务服务。
订单发生变更时,业务服务完成数据库写入,向消息队列投递订单变更事件。消费端一方面更新Redis缓存,另一方面通过WebSocket推送在线用户的所有终端。Redis同时承担分布式锁、订单版本缓存、在线会话映射的能力。MySQL持久化订单主数据、同步日志。
账号体系通过微信UnionID打通,同一个用户在小程序、H5登录后识别为同一个账号,保证订单数据是同一套。
三、乐观锁解决多端并发冲突
订单表增加version版本字段,作为乐观锁标识。每次更新订单信息时,必须带上前端拿到的版本号,只有数据库版本和传入版本一致,才允许更新,更新成功版本号自动+1。版本不匹配直接返回冲突提示,前端提示用户刷新订单后重试。
核心Java代码示例:
@Service
public class HomeOrderSyncService {
@Autowired
private OrderMapper orderMapper;
@Autowired
private ApplicationEventPublisher eventPublisher;
@Transactional(rollbackFor = Exception.class)
public ResultDTO changeAppointTime(Long orderId, Long userId, Integer version, LocalDateTime newTime) {
HomeOrder order = orderMapper.selectById(orderId);
if (order == null || !order.getUserId().equals(userId)) {
return ResultDTO.fail("订单不存在");
}
// 乐观锁更新,版本不匹配则更新行数为0
int updateCount = orderMapper.updateOrderTime(orderId, newTime, version);
if (updateCount <= 0) {
return ResultDTO.fail("订单已在其他终端修改,请刷新订单列表");
}
// 发布订单变更事件
OrderSyncEvent event = new OrderSyncEvent(orderId, userId, order.getOrderStatus(), version + 1);
eventPublisher.publishEvent(event);
return ResultDTO.success();
}
}
四、事件驱动实时推送机制
订单新增、改期、取消、派单、状态变更都会触发事件。消息队列消费事件后,查询该用户下所有在线WebSocket会话,推送订单变更报文。报文携带订单ID、最新状态、版本号、变更类型。
在线终端收到推送后,对比本地缓存版本号,如果服务端版本更高,自动更新页面订单数据。离线用户无法收到WebSocket推送,前端维护同步位点,每次进入订单页面,携带本地最大版本号请求增量同步接口,后端返回该用户所有大于该版本的订单变更记录,实现增量拉取。
通知渠道差异化处理:小程序推送微信订阅消息,H5推送浏览器通知或者站内消息,保证离线用户也能感知订单变化。
五、同步日志与异常兜底补偿
系统单独建立订单同步日志表,记录每一次变更事件、订单ID、用户ID、版本号、推送终端、推送结果。定时任务扫描长时间未确认的同步记录,触发重试推送。
WebSocket推送存在消息丢失风险,因此增量同步作为兜底方案,用户每次打开订单页面都会进行一次版本比对,避免因为推送丢失造成两端数据不一致。同时增加监控告警,当冲突次数、同步失败次数超过阈值时通知运维。
六、前端同步逻辑实现
前端统一封装订单同步工具,本地缓存只作为视图缓存,不视为可信数据源。页面加载时带上本地同步版本号请求增量接口;收到WebSocket推送后优先更新本地缓存。
区分平台存储:同步位点在小程序存入storage,H5存入localStorage。切换账号时清空本地位点,防止不同用户数据串读。页面上所有订单修改操作,提交后等待服务端返回结果,再更新本地视图,不做乐观预更新,减少两端状态错乱。
七、测试验证重点
测试场景覆盖:小程序修改预约时间,H5同时打开订单页面,验证实时推送;两端同时发起改期操作,校验乐观锁拦截;断网后一端提交订单,联网后验证增量同步;H5和小程序交替登录,核对订单状态、预约时间是否一致。同时压测消息队列,避免订单集中变更时消息堆积。
总结
这套同城家政订单实时同步方案,核心是统一数据源、事件驱动推送、乐观锁防并发覆盖。通过UnionID打通账号,WebSocket保障在线实时同步,增量拉取作为离线兜底,适配小程序和H5原生能力差异。该方案可以有效避免家政预约场景下多端订单状态不一致、档期冲突等问题,架构具备良好扩展性,后续可以接入技师APP、管理后台,复用同一套同步逻辑。落地时需要重点做好消息幂等处理、同步日志监控,根据业务峰值调整消息队列和长连接服务资源,保障履约链路稳定。