uni.requestSubscribeMessage调用失败主因是触发时机错误，必须在用户点击事件中立即同步调用，禁止异步回调、setTimeout、onLoad等场景；其次为模板ID未配置、基础库版本过低、未传withSubscriptions:true参数、用户拒绝后未引导openSetting等。
uni.requestSubscribeMessage 调用失败的常见原因
调用 uni.requestSubscribeMessage 无反应或报错 "fail can only be invoked by user TAP gesture"，基本就是触发时机不对。微信强制要求该 API 必须在用户真实点击事件中同步执行，不能包裹在异步回调、setTimeout、onLoad 或 onShow 里。
容易踩的坑包括：
- 把订阅逻辑写在
uni.login成功后的回调里——此时已脱离用户点击上下文 - 按钮绑定了
@click="handleClick"，但handleClick内部又用了await等待其他操作后再调用requestSubscribeMessage - 在 H5 或 APP 端未做平台判断，直接调用导致白屏或报错
正确做法是：点击按钮后，**立即、同步、无中间等待地**调用 uni.requestSubscribeMessage。如果需要前置校验（如登录态），应提前完成，不要塞进点击回调链里。
uni.getSetting({ withSubscriptions: true }) 返回空或无权限数据
withSubscriptions: true 是获取模板订阅状态的唯一有效参数组合。不传、传 false 或只传 success 回调，都拿不到 subscriptionsSetting 字段。
但即使加了这个参数，也可能返回空，原因有：
- 用户从未打开过小程序的消息总开关（即系统级通知权限关闭），此时
mainSwitch为false，itemSettings不会返回任何模板状态 - 用户之前拒绝过某模板，且未通过
openSetting重新授权，后续再调getSetting仍只显示历史拒绝记录，不会自动刷新 - 开发者工具基础库版本低于 2.10.0，该参数被忽略
建议流程：先检查 mainSwitch，若关闭则引导用户去系统设置；再检查具体模板 ID 的 itemSettings[templateId] 值是否为 'accept'，而不是只看是否存在。
解析微信公众号文章，提取标题、作者、正文、图片等信息。用户发送链接（mp.weixin.qq.com）时触发，自动提取内容并可保存至飞书表格。
.NET 后端调用 send 接口时提示 invalid template_id
后端请求 https://api.weixin.qq.com/cgi-bin/message/subscribe/send 报错 {"errcode":47001,"errmsg":"data format error hint..."} 或 invalid template_id，多数不是模板 ID 写错，而是字段结构不匹配。
关键点：
- 模板字段名必须和微信后台「模板详情」页里列出的
name完全一致（如thing1、time2），大小写敏感，不能加空格或下划线 - 每个字段必须是对象，含
value键，且value类型要和模板定义一致（例如time2要传字符串格式时间"2026-04-20 15:30"，不能传Date对象或时间戳） -
touser必须是当前用户的openid，不是unionid；template_id是模板 ID，不是“模板标题”或“模板编号” - 微信要求
page字段必须是小程序内真实存在的路径，否则可能静默失败（不报错但收不到）
调试时可先用固定值硬编码字段，绕过动态拼接逻辑，确认基础通路是否跑通。
用户点了“拒绝”之后还能再弹授权吗
不能直接再调 uni.requestSubscribeMessage。微信限制同一模板 ID 在单次会话中只能触发一次弹窗，用户点“拒绝”后，再次调用只会走 fail 回调，且不会弹窗。
可行的挽回路径只有两条：
- 等用户下次进入小程序时，在合适场景（如提交订单成功页）再次展示引导文案 + 按钮，按钮绑定
uni.openSetting({ withSubscriptions: true })，跳转到系统设置页手动开启 - 在
openSetting成功回调里，再次调用uni.getSetting({ withSubscriptions: true })检查状态，确认用户是否真的开启了对应模板
注意：openSetting 只能打开设置页，无法指定跳转到“消息订阅”子页，用户需自行找到并开启，所以引导文案一定要具体，比如“请在‘消息通知’里找到【XX小程序】并开启”。
