首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政小程序消息通知搭建指南:落地上门订单提醒服务平台

家政小程序消息通知搭建指南:落地上门订单提醒服务平台

原创
作者头像
芮安科技
发布于 2026-11-16 16:53:29
发布于 2026-11-16 16:53:29
130
举报

家政小程序消息通知搭建指南:落地上门订单提醒服务平台

一、家政场景消息通知痛点

家政上门履约链路长,下单、派单、技师接单、上门提醒、完工验收、售后等节点都需要及时通知用户和技师。小程序订阅消息存在授权限制,一旦用户未授权,就无法收到提醒;如果在主业务流程同步调用推送接口,微信接口超时、限流会直接阻塞工单流转。 本文基于SpringBoot+UniApp家政小程序,搭建一套异步、多渠道、可降级的消息通知服务,统一管理订阅消息、站内消息、短信兜底,保障订单节点通知稳定触达。

二、整体技术架构

采用事件驱动、异步解耦的架构,消息模块独立于工单主服务,避免推送故障影响下单履约。

  • 事件生产者:工单服务在状态变更时,发送消息事件到MQ;
  • 消息路由中心:根据消息类型、用户授权状态,选择推送渠道;
  • 推送通道:微信小程序订阅消息、站内WebSocket实时消息、短信兜底;
  • 存储层:MySQL保存消息发送日志、用户授权记录;Redis做幂等控制、频控;
  • 延迟队列:用于预约上门前的定时提醒,例如服务前2小时提醒用户和技师。 核心设计原则:主流程不阻塞、消息可重试、渠道可降级、重复消息拦截。

三、消息节点与渠道策略

家政订单核心通知节点:订单支付成功、平台派单、技师接单、预约上门提醒、技师已到达、服务完工、待评价、订单取消、售后申诉。 渠道分级策略:

  1. 优先小程序订阅消息:成本低,可直接跳转工单详情;需要用户前端主动授权;
  2. 站内WebSocket消息:用户/技师在线打开小程序时实时推送,不受订阅授权限制;
  3. 短信兜底:订阅消息发送失败、用户未授权订阅时,针对高优先级节点触发短信,例如上门提醒、紧急改期。 同时后台配置消息开关,运营可以单独关闭某一类通知,避免骚扰用户。

四、消息幂等与发送核心代码实现

同一个工单状态变更,可能因为重试、回调重复触发推送,必须增加bizId幂等校验,防止重复通知。

代码语言:javascript
复制
@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小时消费任务,触发上门提醒推送。 如果工单中途取消、改期,需要删除对应的延迟消息,避免无效通知。改期后重新投递新的延迟任务,更新提醒时间。

七、重试机制与限流风控

微信接口存在调用频率限制,推送失败区分错误类型处理:

  • 限流、网络超时:进入重试队列,采用退避策略,最多重试3次;
  • 用户拒收、模板ID错误:直接标记失败,不再重试;
  • 短信通道单独设置日发送上限,防止恶意刷消息产生高额费用。 同时增加用户维度频控,同一个用户短时间内同类消息只推送一次,防止消息轰炸。

八、后台管理与监控能力

配套消息管理后台,提供消息记录查询、发送失败统计、模板配置、渠道开关:

  1. 模板管理:维护小程序订阅模板、短信模板,配置模板参数映射;
  2. 消息日志:按工单、手机号、时间段检索,查看发送结果;
  3. 告警监控:监控消息发送失败率,失败率超过阈值触发告警;
  4. 统计报表:统计各渠道到达率,评估订阅消息和短信的使用占比。

九、联调测试要点

  1. 正常流程测试:下单、派单、上门提醒等节点,验证消息按渠道策略下发;
  2. 授权分支测试:用户同意订阅、拒绝订阅两种场景,验证兜底短信是否正常触发;
  3. 幂等测试:重复投递同一bizId消息,确认不会重复推送;
  4. 延迟消息测试:预约工单取消、改期,校验旧提醒任务取消,新提醒按时触发;
  5. 异常测试:微信接口限流、短信通道异常,验证消息日志正常记录,失败任务可重试。

十、总结

家政小程序消息通知服务的核心,是把消息推送从工单主流程剥离,依靠事件队列异步处理,结合订阅消息、站内实时消息、短信兜底的多渠道方案,解决家政预约场景下授权限制、消息漏发、接口阻塞等问题。 幂等控制、延迟队列、分级降级策略是这套方案稳定运行的关键,同时完整的消息日志便于定位漏通知投诉。该通知模块可以独立封装为通用组件,后续可以对接技师APP推送、公众号消息,适配更多终端的通知需求。

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

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

目录
  • 家政小程序消息通知搭建指南:落地上门订单提醒服务平台
    • 一、家政场景消息通知痛点
    • 二、整体技术架构
    • 三、消息节点与渠道策略
    • 四、消息幂等与发送核心代码实现
    • 五、前端订阅消息授权处理
    • 六、延迟提醒实现方案
    • 七、重试机制与限流风控
    • 八、后台管理与监控能力
    • 九、联调测试要点
    • 十、总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档