·更新于 2026年11月15日· 37 次浏览 微信小程序Node.jsRedisMongoDBBUG解决工程实践

微信小程序订阅消息显示发送成功却没收到:我用订阅次数、模板状态和重试日志修好触达

一次活动提醒返回成功但用户没收到,我把问题拆成订阅授权、模板状态、服务端发送和补偿链路,用日志与重试把触达补齐。

微信小程序订阅消息显示发送成功却没收到:我用订阅次数、模板状态和重试日志修好触达 封面
ZHOUYI

作者

ZHOUYI

周末做活动提醒,服务端调用订阅消息后明明拿到成功响应,后台却陆续有人问“没收到通知”。第一反应以为是微信延迟,后来发现不是:接口成功只代表请求被受理,不代表用户端一定可见。我把链路拆开排查,才把这类“假成功”收住。

先确认订阅次数和模板状态

  1. 一次性订阅不是开关,用户点一次授权通常只增加一次发送额度,发完就没了。
  2. 长期订阅要确认类目和审核状态,不是所有小程序都能用,以官方文档为准。
  3. 模板可能被下架、停用或字段格式不符,发送前要做模板可用性检查。
  4. 用户关闭通知、系统权限关闭或账号异常,也会让消息不可见。

把发送变成可追踪任务

我在 Node.js 服务里不再直接“调完就忘”,而是把每次提醒写成 MongoDB 任务:包含 openid、模板 ID、业务 ID、触发时间、errcode、errmsg、重试次数和最终状态。超时、频控或服务异常进入 Redis 延迟队列退避重试;订阅不足、模板失效这类业务错误则停止重试,转人工或站内兜底。

js
const res = await sendSubscribeMessage(payload);
if (res.errcode === 0) {
  await tasks.updateOne({ _id: task._id }, { $set: { status: 'sent', sentAt: new Date() } });
} else if (isRetryable(res.errcode)) {
  await queue.add('subscribe_retry', { taskId: task._id }, { backoff: { type: 'exponential', delay: 30000 } });
} else {
  await tasks.updateOne({ _id: task._id }, { $set: { status: 'failed', reason: res.errmsg } });
}

重试、幂等和兜底

  • 用业务唯一键做幂等,防止活动开始前重复推送。
  • 重试只覆盖不确定失败,不覆盖明确拒绝或额度不足。
  • 发送成功后也保留日志,方便对照用户投诉和触达率。
  • 重要活动加兜底:小程序内提醒、短信或页面公告,别把转化押在一条通知上。

“这次修的不是一个接口,而是把“发送成功”改成“可证明的触达链路”:授权有次数、模板有状态、失败有分类、日志有结果。”

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?