uni-app如何实现小程序端全局消息订阅通知自动下发

uni-app小程序端不能实现“自动下发”的全局消息订阅通知，必须由用户点击button触发uni.requestSubscribeMessage获取授权，后端凭缓存access_token调用微信接口发送，且模板字段名、data结构须严格匹配。

uni-app 小程序端**不能实现“自动下发”的全局消息订阅通知**。微信平台明确禁止任何非用户主动触发的订阅授权行为，所谓“自动下发”在技术上不可行，也违反微信审核规范。真正可行的路径是：**前端只负责引导用户点击授权 + 后端按需调用微信接口推送**。下面分几个关键实操点说清楚。

uni.requestSubscribeMessage 必须由 button 点击触发

这是硬性限制，不是兼容问题。以下写法全部无效：

• uni.requestSubscribeMessage 放在 onLoad、onShow 或 setTimeout 里 → 直接报错 errCode: -1, errMsg: "requestSubscribeMessage:fail api scope is not declared"
• 用 <view @click="xxx"> 或 <text @click="xxx"> 包裹调用 → 微信不识别，静默失败
• <button> 没加 open-type="subscribeMessage" 属性（uni-app 3.0+ 要求）→ 不弹授权框

正确写法只有这一种：

<button open-type="subscribeMessage" @click="handleSubscribe">开启订单提醒</button>

JS 中调用时，tmplIds 建议每次只传 1 个模板 ID，避免用户点“拒绝”后整批失效。

uni.getSetting 检查权限必须带 withSubscriptions: true

很多开发者调了 uni.getSetting() 却拿不到订阅状态，根本原因是漏了这个参数。

• withSubscriptions: false 或不传 → 返回结果里压根没有 subscriptionsSetting 字段
• withSubscriptions: true → 才能拿到 res.subscriptionsSetting.mainSwitch 和 res.subscriptionsSetting.itemSettings
• itemSettings[templateId] 是 undefined？说明该模板从未被请求过，不是“拒绝”，而是“未触达”

别只看 mainSwitch，它只是总开关；真正决定能否发消息的是具体模板的 itemSettings[templateId] 值，可能是 'accept'、'reject' 或 'ban'。

后端发送消息必须用缓存的 access_token

前端拿到 'accept' 后，要立刻把 openid 和模板 ID 传给后端；后端不能每次发都重新拉 access_token。

• access_token 有效期仅 2 小时，且每 2 小时最多获取 1 次，日限 2000 次 → 不缓存必超限
• 必须存在服务端内存或 Redis 中，并带过期时间自动刷新
• 调用地址是：https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=xxx，不是旧的模板消息地址
• data 字段必须严格匹配模板定义的字段名（如 thing1），结构必须是 { value: 'xxx' }，不能直接传字符串

用户点了“拒绝”之后怎么补救

如果后端调用微信接口返回 {"errcode":43101,"errmsg":"user refuse to accept the msg"}，说明用户当时点了“拒绝”，且没再手动打开设置。

• 前端应提示“请前往设置开启”，并立即调用：uni.openSetting({ withSubscriptions: true })
• 注意：这个 API 也必须由用户点击触发，不能自动调；否则会失败
• 不要反复弹窗引导——微信对诱导授权非常敏感，可能被拒审

一次性模板的本质决定了它没法“全局自动下发”。所谓“全局”，只能靠业务侧在关键节点（如下单成功页、支付完成页）精准嵌入授权按钮，而不是幻想一个后台定时任务能推到用户手机上。