小程序分享时怎么自定义转发标题和图片？

康佳的笔记提问于 2026-03-20 12:22:20 阅读 10

移动

我在做微信小程序的分享功能，想让用户点击右上角转发时能带自定义的标题和封面图，但试了 onShareAppMessage 好像没生效。

我页面里写了这个方法，返回了 title 和 imageUrl，但转发出去还是默认的小程序名称和头像。是不是哪里写错了？

onShareAppMessage() {
  return {
    title: '快来一起打卡！',
    imageUrl: '/images/share-cover.jpg'
  }
}

分享转发

我来解答赞 3 收藏

反馈

1 条解答

a'ゞ竞兮 Lv1

首先检查一下你的页面是否正确注册了 onShareAppMessage 方法。在微信小程序中，这个方法需要在页面的 Page 构造器中定义，确保它是在正确的页面文件中。

需要注意的是，onShareAppMessage 方法只有在用户点击右上角菜单中的“转发”按钮时才会被调用。如果你测试的时候没有看到效果，可能是因为触发条件没有满足。

接下来，确保 imageUrl 路径是正确的，并且图片已经上传到服务器或者小程序的本地资源路径中。这里有个常见的坑，就是图片路径必须是可以直接访问的 URL 或者是小程序本地路径（以 / 开头的相对路径）。微信不支持临时路径或者通过 require 引入的图片路径。

以下是正确的代码示例，你可以参考一下：

// 在页面对应的 js 文件中

Page({

  onShareAppMessage: function () {

    // 返回一个对象，包含分享的配置信息

    return {

      title: '快来一起打卡！', // 自定义分享标题

      path: '/page/index/index?id=123', // 可选，转发后打开的页面路径，可以带上参数

      imageUrl: '/images/share-cover.jpg' // 自定义分享图片，路径需正确

    }

  },

  onLoad: function () {

    // 页面加载时的逻辑

  }

});

在这个例子中，path 是可选参数，用来指定转发后打开的页面路径以及传递给该页面的参数。虽然题目没有提到，但是为了完整性我加进去了。

最后，确保你的图片大小和格式符合微信的要求。根据微信官方文档，分享图片的大小建议为 5:4 比例，最大不超过 32KB。如果图片过大，可能会导致分享失败。

希望这些信息对你有帮助，祝你调试顺利。有时候微信的缓存可能会有点烦人，记得清理一下缓存再试试哦。

2026-03-20 14:42