微信内置浏览器要求分享必须由用户真实点击原生button或a标签触发，且需同步调用WeixinJSBridge接口，不得异步延迟；同时须完成JS-SDK配置验证，域名备案、HTTPS有效、URL一致、jsApiList显式声明，并在ready回调中绑定逻辑。
微信内置浏览器不支持 JS 主动调起分享弹窗
直接用 button 绑定 onclick 调用 WeixinJSBridge 或 WXJSSDK 的 shareTimeline 等方法，99% 情况下会失败——微信从 2020 年起强制要求：分享接口必须由用户真实点击触发，且不能经过任何异步延迟（比如 setTimeout、Promise.then）、不能在 Ajax 回调里调用、不能由 addEventListener 的代理事件间接触发。
必须用原生 <button> 或 <a> 的同步 click 事件
微信只认“用户手指落下 + 抬起”这一连贯动作产生的原生 click 事件。以下写法才可能生效：
<button id="shareBtn">分享给朋友</button>
<script>
document.getElementById('shareBtn').onclick = function () {
// 必须立刻执行，不能有 await / setTimeout / fetch.then
if (typeof WeixinJSBridge !== 'undefined') {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "",
"img_url": "https://example.com/icon.png",
"img_width": "120",
"img_height": "120",
"link": "https://example.com/",
"desc": "这是一条分享",
"title": "标题"
}, function (res) {});
}
};
</script>
- 按钮必须是 DOM 原生元素，不能是 Vue/React 渲染的“伪按钮”（如
<div @click>） - 事件监听必须用
onclick属性或element.onclick = fn，避免用addEventListener('click', ...)（部分旧版微信不识别） - 函数体第一行就要调用分享 API，中间不能有任何异步操作
需要提前注入 JS-SDK 并完成 config 验证
即使点击合规，没通过微信 JS-SDK 配置也会报错 config:invalid signature 或 permission denied。关键点：
- 后端必须用企业认证公众号的
appid和appsecret获取access_token，再用它换取jsapi_ticket - 前端传入
config的url必须和当前页面完整 URL 一致（含#后参数，但微信会自动截断 hash） -
jsApiList中必须显式写入'sendAppMessage'（朋友）、'shareTimeline'（朋友圈），大小写敏感 - 务必在
ready回调里绑定按钮逻辑，不能在error或未触发时就绑定
真机调试时常见失败原因
开发时在 Chrome 模拟微信环境永远不生效，必须用 iOS/Android 微信客户端扫码访问：
立即学习“前端免费学习笔记（深入）”；
- 页面域名未在公众号「JS接口安全域名」中配置（注意：不支持
localhost、127.0.0.1、IP 地址） - HTTPS 证书无效或过期（微信强制要求 HTTPS）
- 用户不是关注该公众号的粉丝（部分接口如
openLocation有此限制，但分享无此要求） - 微信版本过低（建议 ≥ 8.0.20）或开启了「网页版微信」等非标准内核
- 分享参数中
link域名与当前页不一致，或img_url返回非 200 状态码
最易被忽略的是：分享弹窗本身没有 UI 反馈机制，调用后静默失败很常见。务必在 success/cancel/fail 回调里加 console.log 或埋点，否则根本不知道卡在哪一步。
