微信分享卡片必须通过JS-SDK调用updateAppMessageShareData/updateTimelineShareData设置，不依赖meta标签；图片需HTTPS、≥300×300px且分享时可匿名访问；iOS缓存分享数据，安卓需每次重设。
微信内分享链接时不会自动显示美观的卡片，必须通过 JS-SDK 注入特定 metadata 和签名配置——不接入 JS-SDK，光靠 <meta> 标签完全无效。
为什么加了 <meta name="description"> 还是不显示摘要？
微信客户端根本不读取 HTML 的 <meta> 标签来生成分享卡片。它只信任后端签发的 JS-SDK 权限和前端调用的 updateAppMessageShareData / updateTimelineShareData 接口。
- 所有视觉字段（标题、描述、图片）必须由 JS 调用设置，且仅在用户触发分享动作前生效
-
<meta>只对非微信环境（如 QQ、微博、浏览器直链）起作用 - 图片必须是 HTTPS 协议、尺寸建议 ≥ 300×300px，否则微信可能降级为默认图标
JS-SDK 初始化失败的三个高频原因
常见错误信息：config: invalid signature 或 permission denied，本质是签名环节出错。
- 后端生成
jsapi_ticket时没缓存，每次请求都重新拉取（有效期2小时），导致签名过期或频率超限 - 签名用的
nonceStr和timestamp没传给前端，或前端拼接 URL 时未严格按「键名升序 + & 拼接」规则（比如把jsapi_ticket写成jsapi_tiket） - 调用
wx.config()的jsApiList里漏写了updateAppMessageShareData（iOS 微信 7.0.12+ 和安卓 8.0.30+ 已强制要求）
updateAppMessageShareData 和 updateTimelineShareData 怎么选？
前者控制「发送给朋友」和「分享到聊天」的卡片，后者控制「分享到朋友圈」——两者必须分开调用，不能复用同一组参数。
立即学习“前端免费学习笔记（深入）”；
- 朋友圈卡片不支持
desc字段，只显示title和imageUrl；而好友分享必须提供desc，否则摘要为空 - 两个接口都需在
wx.ready回调中执行，且每次分享前都应重置（例如监听beforeunload或路由变化后重新 set） - 若页面是单页应用（SPA），
location.href必须是当前真实 URL（含 hash），不能是 base URL，否则签名校验失败
安卓 vs iOS 在分享行为上的关键差异
iOS 微信会缓存首次设置的分享数据，后续不调用 updateAppMessageShareData 也可能沿用旧内容；安卓则每次打开页面都清空，必须显式调用。
- 测试时务必分别用两台设备验证，不能只看 iOS 表现就认为 OK
- 安卓下如果分享无反应，先检查是否因异步加载导致
wx.ready触发后又覆盖了分享数据（比如图片 URL 异步返回后再 set，但此时已错过时机） - 微信内置浏览器 UA 会随版本变化，不要依赖
navigator.userAgent做兼容判断，以 JS-SDK 返回的ready/error状态为准
最易被忽略的一点：微信分享卡片的图片不是「设完就生效」，而是微信客户端在用户点击分享按钮的瞬间抓取并缓存。如果图片 URL 后端做了权限控制（如带临时 token），必须确保该 URL 在分享发生时仍可匿名访问，否则卡片显示空白图。
