微信小程序订阅消息需用户主动授权且后端调用微信接口，仅支持一次性模板；uni.requestsubscribemessage必须绑定button点击事件并设open-type="subscribemessage"，禁止自动调用。
uni.requestSubscribeMessage 必须由用户点击触发
微信强制要求：不能在页面 onLoad、onShow 或定时器里自动调用 uni.requestSubscribeMessage，否则直接报错或静默失败。这是最常被忽略的硬性限制。
- 只能绑定在
<button></button>的@click事件里，且按钮需设置open-type="subscribeMessage"（uni-app 3.0+ 支持）或纯 JS 调用 - 若用户点过一次并选了“拒绝”，再次调用会直接进
fail回调，不会弹窗；此时需引导用户手动去「设置页」开启：uni.openSetting({withSubscriptions: true}) - 模板 ID 数组最多传 10 个，但建议只传 1 个——避免用户因多选疲劳而全拒
前端怎么判断用户是否已授权某模板
不能只靠 uni.getSetting({withSubscriptions: true}) 看 mainSwitch，那只是总开关。关键要看具体模板 ID 的状态：
-
itemSettings['YOUR_TEMPLATE_ID']返回'accept'：已授权，可直接发（但注意：一次性模板发完即失效） - 返回
'reject'：用户明确拒绝，再调用requestSubscribeMessage不会弹窗 - 返回
'ban'：该模板被微信封禁（极少，但真有） - 字段不存在：说明用户从未对该模板做过选择，此时才是调用
requestSubscribeMessage的合适时机
别漏掉 withSubscriptions: true 参数，不加这个，itemSettings 根本不会返回。
后端发消息时最易踩的三个坑
前端拿到 accept 只是第一步，后端真正调用微信接口发消息时，失败率极高，主因在以下三点：
微信聊天分析及预测工具
下载
微信聊天分析助手 v2.1.0 — 完全本地运行的隐私保护工具。 分析聊天记录，推断 MBTI 与大五人格，检测情感趋势，生成可视化报告。 支持 jieba 精准分词、否定识别、反讽检测、风险预警。 内置 RAG 检索增强预测和多智能体博弈模拟，完全本地化、零数据外传。 可选 MiroFish 群体智能引擎增强对话预测。
-
access_token必须缓存且校验有效期：微信限制每两小时刷新一次，且有调用频次限制；硬编码或每次重取都会导致 40001 错误 -
touser字段必须是当前小程序的openid：跨小程序、用测试号 openid、或拿错用户登录态（比如用了公众号 openid），都会返回errcode: 43101 - 模板字段名必须和后台申请时完全一致：比如你申请模板时字段叫
thing1，代码里写成content或message，微信直接忽略该字段，不报错但内容为空
发送接口地址是 https://api.weixin.qq.com/cgi-bin/message/subscribe/send，不是旧的模板消息地址，别混淆。
模板 ID 和字段名从哪来、怎么配
所有模板 ID 和字段名都来自微信公众平台后台，不是前端随便写的：
- 入口：小程序后台 → 功能 → 订阅消息 → 公共模板库 → 搜索关键词（如“订单发货”）→ 点击“选用”
- 选用后进入详情页，复制顶部的
模板ID（一长串含字母数字的字符串） - 下方“模板内容”区域会列出字段名，如
character_string1、time2、thing3等——这些就是你在后端data对象里必须严格使用的 key - 字段 value 值长度有限制（一般 ≤ 15 字符），超长会被截断，且不报错
模板审核通过前，后端调用发送接口会返回 errcode: 47001，前端无感知，容易误判为“发成功了”。
