萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

微信 JSSDK 分享配置完整指南:標題、縮略圖、連結、描述自訂

前置準備

  1. 微信公眾號後台 → 設定 → 公眾號設定 → 功能設定 → **JS介面安全域名** 填寫你的網域(不帶協議/埠)。
  2. 引入 JSSDK:<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
  3. 後端簽名:取得 access_token → jsapi_ticket → 簽名算法(noncestr, timestamp, url, jsapi_ticket 字典序拼接 SHA1)。

前端配置代碼

<script>
// 後端渲染或 AJAX 取得簽名配置
var wxConfig = {
  appId: '{{appId}}',           // 公眾號 AppID
  timestamp: {{timestamp}},     // 時間戳
  nonceStr: '{{nonceStr}}',     // 隨機字串
  signature: '{{signature}}',   // 簽名
  jsApiList: [
    'updateAppMessageShareData',  // 分享給好友 (1.4.0+)
    'updateTimelineShareData',    // 分享到朋友圈 (1.4.0+)
    'onMenuShareAppMessage',      // 舊版相容
    'onMenuShareTimeline'         // 舊版相容
  ]
};

wx.config(wxConfig);

wx.ready(function() {
  var shareData = {
    title: '【活動】報名試駕,贏取精美禮品',      // 標題
    desc: '掃碼參加奧迪 Q3 尊享禮遇季活動',         // 描述
    link: 'https://topic.example.com/2024/ad_q3/',    // 分享連結(必須與簽名 url 同域)
    imgUrl: 'https://topic.example.com/2024/ad_q3/banner.jpg', // 縮略圖 (300x300 建議)
    success: function() { console.log('分享設定成功'); },
    cancel: function() { console.log('使用者取消分享'); }
  };

  // 新版介面 (1.4.0+) —— 直接設定分享資料,不需使用者點選選單
  wx.updateAppMessageShareData(shareData);
  wx.updateTimelineShareData(shareData);

  // 舊版介面相容 —— 使用者點選選單時觸發
  wx.onMenuShareAppMessage(shareData);
  wx.onMenuShareTimeline(shareData);
});

wx.error(function(res) {
  console.error('JSSDK 配置失敗:', res.errMsg);
  // 常見:invalid signature、url mismatch、domain not allowed
});
</script>

關鍵坑點與解決

問題原因解決
invalid signature簽名算法錯誤 / url 不一致url 必須為**當前頁面完整 URL**(含 query string,去掉 #hash),後端按相同 url 簽名
分享出去圖片不顯示圖片域名不在安全域名 / 圖片過大 / 防盜鏈圖片放同域或配置圖片域名;<300KB;允許微信回源
iOS 分享標題被截斷標題過長建議 < 32 字
安卓無法觸發 success舊版 JSSDK 行為差異同時呼叫新舊版 API;實測以新版為準

動態更新分享內容(SPA 路由切換)

function updateWxShare(data) {
  if (!window.wx) return;
  wx.ready(function() {
    wx.updateAppMessageShareData(data);
    wx.updateTimelineShareData(data);
  });
}

// Vue Router / React Router 切換頁面時呼叫
router.afterEach((to) => {
  updateWxShare({
    title: to.meta.shareTitle,
    desc: to.meta.shareDesc,
    link: window.location.href,
    imgUrl: to.meta.shareImg
  });
});

企業微信/小程序差異

  • 企業微信:使用 wx.qy.selectEnterpriseContact 等專屬 API,分享配置同理。
  • 小程序:使用 onShareAppMessage、onShareTimeline 生命週期函式,非 JSSDK。
copyright © 萬盛學電腦網 all rights reserved