uni.requestSubscribeMessage必须在用户点击5秒内调用，否则静默失败；需绑定按钮事件首行执行，配合withSubscriptions:true的uni.getSetting校验状态，iOS不支持uni.openSetting跳转订阅设置，模板ID须审核通过且格式严格。
uni.requestSubscribeMessage 调用必须卡在用户点击的 5 秒内
微信底层硬性限制：该 API 只能在用户主动触发（如 @click、tap）后 5 秒内执行，超时就静默失败——不报错、不弹窗、fail 回调可能直接不触发，或只返回 errCode: 20004。
常见错误现象包括：
- 页面
onLoad里直接调用，控制台无提示但始终没弹窗 - 异步请求（如登录成功后）回调里调用，用户点按钮到接口返回有延迟，大概率失效
- 用
setTimeout模拟“稍后引导”，哪怕只延 100ms 也大概率失败
实操建议：
- 绑定到按钮的
@click或bindtap事件中，且函数体第一行就调用uni.requestSubscribeMessage - 按钮文案要具象，例如“开启发货提醒”比“授权通知”点击率高 3 倍以上
- 避免在
success回调里嵌套二次调用——一次只传一个或少数几个模板 ID，别贪多
uni.getSetting 必须带 withSubscriptions: true 才能读取订阅状态
很多人调 uni.getSetting() 后发现 res.subscriptionsSetting 是 undefined，根本原因是没传参数 withSubscriptions: true。不加这个，微信压根不返回订阅相关字段。
返回结构嵌套深、类型不统一，典型判断逻辑是：
-
res.subscriptionsSetting?.mainSwitch === false：用户关闭了总开关，需引导去系统设置 -
res.subscriptionsSetting?.itemSettings?.[tmplId] === 'accept'：该模板已授权，可跳过后续弹窗 -
res.subscriptionsSetting?.itemSettings?.[tmplId] === 'reject'：用户明确拒绝过，再次调用仍会弹窗（除非点了“不再提示”） -
res.subscriptionsSetting?.itemSettings?.[tmplId] === 'ban'：被后台封禁，不用再试
注意：itemSettings 是对象，键为模板 ID 字符串，值为字符串 'accept'/'reject'/'ban'，不是布尔值，也不是数字。
uni.openSetting 在 iOS 上不显示订阅消息入口
调 uni.openSetting({ withSubscriptions: true }) 后，Android 会展示包含“订阅消息”的权限列表页，但 iOS 完全不显示该入口——这是微信官方限制，不是代码 bug。
这意味着：
- iOS 用户如果关了总开关或拒绝过某个模板，你无法通过
uni.openSetting把他拉回去重新授权 - 只能靠文案引导：“请前往「微信 > 我 > 设置 > 新消息通知 > 订阅消息」手动开启”
- 调完
uni.openSetting后建议立刻uni.navigateBack()或uni.reLaunch()，否则用户设置完不会自动回到你的页面
别指望用 JS 跳转到具体子页面，微信不支持，uni.navigateTo 也无效。
模板 ID 必须已在公众号平台审核通过且传对格式
tmplIds 参数必须是数组，每个元素是微信公众平台「我的模板」里已添加并审核通过的完整模板 ID 字符串，例如 'c6DX7UbTOL1hciWxbdeTjBr-FWQrFXO5z9VDXXXXXXXX'。少一位、多空格、大小写错、用了测试 ID 都会直接失败，且错误信息极不友好（常为 fail: invalid template id）。
关键细节：
- 公共模板库选中的模板，需点击“选用”后复制 ID，不是预览页 URL 里的那段
- 自定义模板需提交审核，审核通过前 ID 不可用
- 不同环境（开发版、体验版、正式版）共用同一套模板 ID，无需区分
- 一次性订阅模板每次使用后即失效，后端收到
res[tmplId] === 'accept'后，只应上报 1 次授权，不是“授权次数 × N”
最易忽略的一点：前端拿到 accept 后，只是拿到了一次性的授权凭证，真正发消息依赖后端调用微信服务端接口，前端不参与发送过程——别在 success 里自己拼 data 去发请求。
