onShareAppMessage必须在页面组件export default中定义，返回对象字段严格受限：title≤48字符，path须为合法HTTPS路径并编码参数，imageUrl必须是可访问的HTTPS地址，动态参数需在onLoad中解析并响应式绑定。
onShareAppMessage 必须在页面级定义且返回对象字段严格
uni-app 小程序端的分享卡片不是靠全局配置生效的，onShareAppMessage 必须直接写在页面组件（如 pages/product/detail.vue）的 export default 选项中，不能放在 mixin、store 或 app.vue 里。微信原生机制只识别当前页面导出的该函数。
返回对象字段有硬性限制：
-
title：最多 48 字符，超长会被截断不换行 -
path：必须是合法小程序页面路径，如/pages/product/detail；传参只能用?key=value形式，中文/空格/特殊符号必须encodeURIComponent()处理 -
imageUrl：必须是 HTTPS 网络地址，/static/share.jpg这类本地路径无效；建议用 CDN 地址并提前验证浏览器可直访问 - 不支持
desc、success回调等非标准字段，加了会被忽略
动态参数依赖 onLoad 接收 + 页面数据响应式拼接
用户点击分享时，onShareAppMessage 函数会立即执行，但此时页面可能还没拿到路由参数或异步数据。如果直接写死 path: '/pages/product/detail?id=123'，就无法反映当前真实商品 ID。
正确做法是把参数存在响应式变量里，在 onLoad 中解析并赋值：
- 在
onLoad((options) => { this.productId = options.id })中接收 URL 参数 - 用
ref或data声明productId，确保onShareAppMessage能读取最新值 - 拼接 path 时做防御处理：
path: `/pages/product/detail?id=${this.productId || 'default'}` - 若需携带多级来源信息（如
share_from=user_789），统一用encodeURIComponent编码后再拼入 query
朋友圈分享 onShareTimeline 需三重开关且不支持 option.from
onShareTimeline 和 onShareAppMessage 是两个独立函数，且朋友圈分享失败常无声无息——控制台不报错，菜单里就是不显示入口。
必须同时满足三项才生效：
-
manifest.json中勾选 “Share(分享)” 模块，并填对微信 AppID -
pages.json对应页面配置项加"enableShareTimeline": true - 微信公众平台后台 → 小程序设置 → 功能设置 → 手动开启 “分享到朋友圈” 开关（2026 年仍需人工开通）
另外注意：onShareTimeline 的入参 option 始终为空对象，option.from 在这里永远是 {}，无法区分右上角触发还是按钮触发；它只响应右上角菜单，不能被 <button open-type="share"> 调起。
uView-plus 等 UI 库会劫持 share 配置，需改用 mpShare 对象
如果你项目用了 uview-plus 或类似封装库，直接在 onShareAppMessage 里 return 对象是无效的——库内部会拦截并改用自己维护的 mpShare 对象。
必须通过实例代理修改：
- 用
const that = getCurrentInstance()获取当前页面实例 - 写成
that.proxy.mpShare.title = 'xxx'、that.proxy.mpShare.path = '/pages/xxx?...' -
imageUrl同样要赋给mpShare.imageUrl，不能只写在 return 对象里 - 务必确认你用的 UI 库文档是否明确说明了该行为，避免白忙活
路径拼错、图片 404、三重开关漏一环、UI 库劫持未察觉——这四点占了实际开发中 90% 的“分享不生效”问题。别急着查 SDK 版本或重装依赖，先对着这几条逐项核对。
