微信分享卡片必须通过JS-SDK的updateAppMessageShareData和updateTimelineShareData设置，meta标签完全无效；需确保wx.config成功、参数完整且HTTPS合规，并区分iOS缓存与安卓实时加载特性。
微信分享卡片的标题、描述、图片无法自定义，不是代码没写对，而是根本没走对流程——meta 标签在微信里基本无效，必须用 JS-SDK 的 updateAppMessageShareData 和 updateTimelineShareData 才能生效。
为什么标签在微信里不生效
很多开发者在 <head> 里加了 <meta name="description" content="..."> 或 <meta itemprop="image" content="...">，以为这样就能控制分享效果。实际测试中，这些标签只对部分安卓浏览器或微信内嵌 WebView 的极早期版本有微弱影响，2026 年起已完全不可靠。微信官方明确说明：分享数据由 JS-SDK 控制，且仅支持 HTTPS 页面。
- 微信 iOS 客户端会缓存上一次成功设置的分享数据，改了代码不生效，大概率是缓存没清或 config 失败后 fallback 到旧值
- 安卓客户端则每次打开页面都重新拉取，但若
updateAppMessageShareData调用时机不对（比如在wx.ready外执行），就会退回到默认标题（页面 title）和首张图片 -
meta中的itemprop属性只在 Google 搜索、结构化数据场景有用，和微信无关
必须调用 updateAppMessageShareData 而不是 onMenuShareAppMessage
微信从 1.4.0 版本起废弃了 onMenuShareAppMessage 和 onMenuShareTimeline，新项目必须用 updateAppMessageShareData（分享给朋友）和 updateTimelineShareData（分享到朋友圈）。老代码即使能跑，也会在部分 iOS 微信版本中静默失败。
- 调用前必须确保
wx.config成功，且jsApiList包含updateAppMessageShareData和updateTimelineShareData - 参数必须完整：
title、desc、link、imgUrl缺一不可；link必须与当前页面同域（不能是跳转页），且协议、子域名、路径都要匹配 JS 安全域名白名单 -
imgUrl必须是 HTTPS 地址，尺寸 ≥ 300×300px，且图片资源在分享时可匿名直链访问（不能带登录态 cookie 或 referer 限制） - 不要在
mounted或DOMContentLoaded后立刻调用——要等wx.ready回调触发后再执行，否则 SDK 还没初始化完
常见 config 失败原因：invalid signature / invalid url domain
报 config:invalid signature 或 config:invalid url domain 是最常卡住的环节，本质是签名生成逻辑或域名配置出错，和前端 JS 关系不大，但排查路径容易误判。
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
立即学习“前端免费学习笔记（深入）”；
-
invalid url domain：不是当前页面 URL 没备案，而是wx.config中传入的url字段值，必须是「未 hash、未 query 参数截断」的纯净 URL（如https://example.com/share.html），且该域名已在公众号后台「JS 接口安全域名」中完整填写（不带http://或路径） -
invalid signature：90% 是后台签名时用了错误的jsapi_ticket（过期/未刷新）或拼接字符串时未对 URL 做encodeURIComponent；注意：URL 必须是前端实际访问的完整地址，不能是服务端拼的、带临时参数的链接 - iOS 微信会强缓存 config 结果，哪怕你改了签名，只要 URL 不变，就可能复用旧缓存——临时调试可加时间戳参数（如
?t=123）绕过，上线前务必去掉
安卓 vs iOS 分享行为差异必须手动适配
同一套代码在两个平台表现不同，不是 bug，是微信设计如此。iOS 缓存分享数据、安卓每次重设，意味着你不能依赖“页面加载一次就设置好”，而要确保每次用户触发分享动作前，数据都是最新的。
- iOS：如果用户第一次进页面设置了分享数据，之后跳转到同域其他页再返回，仍显示第一次的标题和图——除非你主动再次调用
updateAppMessageShareData - 安卓：每次进入页面都会重走
wx.ready→updateXXX流程，但如果页面用 Vue Router / React Router 切换路由（非整页刷新），wx.ready不会二次触发，必须手动监听路由变化并重设 - 图片加载失败时，iOS 会 fallback 到页面第一个
<img>，安卓直接显示默认图标——所以建议把占位图<img src="..." style="display:none">放在<body>开头，但不要用display:none隐藏真实分享图
最易被忽略的一点：微信分享不是“设一次就完事”的静态配置，而是一个运行时动态注入过程。任何环节——签名生成、URL 传递、SDK 加载顺序、图片可访问性、iOS 缓存策略——断掉一环，都会导致卡片回退到原始 title 和首图。别猜，用真机 + debug: true 看控制台输出，比读文档快十倍。
