家政上门履约链路长,下单、派单、技师接单、上门提醒、完工验收、售后等节点都需要及时通知用户和技师。小程序订阅消息存在授权限制,一旦用户未授权,就无法收到提醒;如果在主业务流程同步调用推送接口,微信接口超时、限流会直接阻塞工单流转。 本文基于SpringBoot+UniApp家政小程序,搭建一套异步、多渠道、可降级的消息通知服务,统一管理订阅消息、站内消息、短信兜底,保障订单节点通知稳定触达。
采用事件驱动、异步解耦的架构,消息模块独立于工单主服务,避免推送故障影响下单履约。
家政订单核心通知节点:订单支付成功、平台派单、技师接单、预约上门提醒、技师已到达、服务完工、待评价、订单取消、售后申诉。 渠道分级策略:
同一个工单状态变更,可能因为重试、回调重复触发推送,必须增加bizId幂等校验,防止重复通知。
@Service
public class MsgPushService {
@Autowired
private RedisTemplate<String, Object> redisTemplate;
@Autowired
private WxSubscribeMsgService subscribeMsgService;
@Autowired
private SmsService smsService;
public void pushOrderMsg(OrderMsgDTO dto) {
String key = "msg:idempotent:" + dto.getBizId();
Boolean exist = redisTemplate.hasKey(key);
if(Boolean.TRUE.equals(exist)){
return;
}
// 优先发送订阅消息
boolean subResult = subscribeMsgService.send(dto.getOpenId(), dto.getTemplateId(), dto.getData(), dto.getPage());
if(!subResult && dto.getUrgent()){
// 紧急消息订阅失败,走短信兜底
smsService.send(dto.getPhone(), dto.getSmsTemplateId(), dto.getSmsParam());
}
redisTemplate.opsForValue().set(key, 1, 12, TimeUnit.HOURS);
// 写入消息日志
saveMsgLog(dto, subResult);
}
}消息日志表记录工单ID、接收人、渠道、模板ID、发送状态、返回码,方便后续排查漏通知问题。
小程序端在下单、确认预约等关键节点,调用wx.requestSubscribeMessage拉起订阅授权弹窗,将授权结果回传给后端,记录用户是否同意对应模板消息。 家政场景大多是一次性订阅消息,无法长期授权,所以需要在每次下单流程中按需申请授权;技师端可以搭配服务号消息补充,弥补一次性订阅的限制。 WebSocket长连接用于小程序在线状态下的实时提醒,技师打开小程序时,新订单可以即时弹窗提示接单。
预约单的上门提醒属于定时消息,不能轮询数据库。使用延迟消息队列实现:用户提交预约工单,投递一条延迟消息,到预约时间前2小时消费任务,触发上门提醒推送。 如果工单中途取消、改期,需要删除对应的延迟消息,避免无效通知。改期后重新投递新的延迟任务,更新提醒时间。
微信接口存在调用频率限制,推送失败区分错误类型处理:
配套消息管理后台,提供消息记录查询、发送失败统计、模板配置、渠道开关:
家政小程序消息通知服务的核心,是把消息推送从工单主流程剥离,依靠事件队列异步处理,结合订阅消息、站内实时消息、短信兜底的多渠道方案,解决家政预约场景下授权限制、消息漏发、接口阻塞等问题。 幂等控制、延迟队列、分级降级策略是这套方案稳定运行的关键,同时完整的消息日志便于定位漏通知投诉。该通知模块可以独立封装为通用组件,后续可以对接技师APP推送、公众号消息,适配更多终端的通知需求。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。