·更新于 2026年11月15日· 37 次浏览 微信小程序Node.jsRedisMongoDBBUG解决工程实践
微信小程序订阅消息显示发送成功却没收到:我用订阅次数、模板状态和重试日志修好触达
一次活动提醒返回成功但用户没收到,我把问题拆成订阅授权、模板状态、服务端发送和补偿链路,用日志与重试把触达补齐。

作者
ZHOUYI
周末做活动提醒,服务端调用订阅消息后明明拿到成功响应,后台却陆续有人问“没收到通知”。第一反应以为是微信延迟,后来发现不是:接口成功只代表请求被受理,不代表用户端一定可见。我把链路拆开排查,才把这类“假成功”收住。
先确认订阅次数和模板状态
- 一次性订阅不是开关,用户点一次授权通常只增加一次发送额度,发完就没了。
- 长期订阅要确认类目和审核状态,不是所有小程序都能用,以官方文档为准。
- 模板可能被下架、停用或字段格式不符,发送前要做模板可用性检查。
- 用户关闭通知、系统权限关闭或账号异常,也会让消息不可见。
把发送变成可追踪任务
我在 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 } });
}重试、幂等和兜底
- 用业务唯一键做幂等,防止活动开始前重复推送。
- 重试只覆盖不确定失败,不覆盖明确拒绝或额度不足。
- 发送成功后也保留日志,方便对照用户投诉和触达率。
- 重要活动加兜底:小程序内提醒、短信或页面公告,别把转化押在一条通知上。
“这次修的不是一个接口,而是把“发送成功”改成“可证明的触达链路”:授权有次数、模板有状态、失败有分类、日志有结果。”