前置準備
- 微信公眾號後台 → 設定 → 公眾號設定 → 功能設定 → **JS介面安全域名** 填寫你的網域(不帶協議/埠)。
- 引入 JSSDK:
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
- 後端簽名:取得
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。