必须。微信对分享路径中的query string有严格校验，未编码的中文、空格、特殊符号会导致解析失败，出现白屏或404；推荐写法为path: /pages/product/detail?id=${encodeuricomponent(productid)}&share_from=${encodeuricomponent(shareid)}。
onShareAppMessage 里 path 参数必须 encodeURI 吗？
必须。微信对分享路径中的 query string 有严格校验，未编码的中文、空格、特殊符号（如 &、=、/）会导致路径解析失败，用户点击后跳转白屏或 404。
常见错误现象：分享卡片显示正常，但点击后卡在 loading 或直接回到首页——大概率是 path 里参数没做 encodeURIComponent。
-
path字段只接受合法的小程序页面路径 + URL 查询参数，不能含 hash（#）、不能拼接完整 URL - 推荐写法：
path: `/pages/product/detail?id=${encodeURIComponent(productId)}&share_from=${encodeURIComponent(shareId)}` - 如果用 Vue3
ref或computed动态生成，记得在 return 前统一 encode，别只 encode 部分字段
button 分享和右上角菜单分享怎么区分并返回不同内容？
靠 e.from === 'button' 判断，这是唯一可靠方式。微信会在按钮触发时传入 from: 'button'，菜单分享则是 from: 'menu'。
容易踩的坑：很多人在 onShareAppMessage 里直接 return 固定对象，结果所有分享都一样——必须把判断逻辑写进去，且优先处理 button 场景。
- 按钮需带
data-xxx属性透传数据，例如：<button open-type="share" :data-id="item.id" :data-title="item.name"></button> - 在回调里用
e.target.dataset.id和e.target.dataset.title取值，别用event.currentTarget（不兼容） - 菜单分享 fallback 要兜底，比如返回首页路径或默认活动页，避免空 return 导致分享失败
imageUrl 加载失败导致卡片变文字链接，怎么排查？
不是图片地址写错那么简单。微信要求分享图必须满足三个硬性条件：HTTPS 协议、域名已配置 downloadFile 白名单、图片能被微信服务器直连访问（不能 302 跳转或需 referer）。
最常被忽略的是白名单——即使你用了 HTTPS，没在小程序后台「开发管理 → 开发者工具 → request 合法域名」里加域名，imageUrl 就会静默失效，卡片退化为纯文本。
- 测试方法：把
imageUrl粘贴到手机微信内置浏览器里打开，看能否直接显示图片 - 本地路径（如
/static/share.jpg）完全无效，朋友圈分享更强制要求网络图 - 动态拼接图地址时，确保变量非空，比如
item.cover || '/static/default-share.jpg'
uView-plus 或其他 UI 库下 onShareAppMessage 不生效？
因为这类库做了全局 mixin 封装，会劫持原生分享逻辑。直接写 onShareAppMessage(() => {...}) 没用，它根本不会调用你写的函数。
必须改用库提供的分享配置入口，比如 uView-plus 的 mpShare 对象。否则你在控制台看不到报错，但分享卡片永远是默认样式。
- 查文档确认库是否覆盖了分享机制，别凭经验写原生钩子
- 正确写法示例：
getCurrentInstance().proxy.mpShare.title = 'xxx'; mpShare.path = '/pages/...?id=123'; - 注意
mpShare是响应式对象，赋值要等组件 mounted 后，否则可能被覆盖
