微信端有一個新增拍品的頁面,需要照片上傳功能。做法是在主頁面開啟一個 iframe,子頁面用 canvas 承載「透過微信 JSSDK 選擇圖片介面」挑到的圖片(微信會回傳一個形如 weixin://xxxx 的 localId,可直接放進 img 的 src 預覽),支援放大縮小、移動、旋轉等操作,按下確定後把編輯好的圖片送到伺服器存成檔案。
子頁面功能開發完成後,從主頁面以 iframe 開啟,卻無法呼叫微信 JSSDK 的選擇圖片介面,其他 JSSDK 介面也一併失效。但單獨開啟子頁面一切正常,主頁面的微信分享等功能同樣正常。
第一個懷疑對象是「主頁面與子頁面同時注入了 JSSDK 的簽名資訊,是否衝突」。實測後排除這種可能。
接著搜尋到一則網友的提問,描述的現象與我類似,但沒有解答。
最後嘗試的方案是:只在主頁面做簽名驗證,子頁面不注入 JSSDK 簽名資訊;需要呼叫 JSSDK 介面時,在函式前加上 parent.,改為呼叫父頁面的該函式。實測可正常運作。
parent.wx.chooseImage({
success: function (res) {
// upload_success(res.localIds);
}
});
原因不難理解:微信的 JSSDK 簽名是綁定「當前頁面 URL」計算出來的,而 iframe 內頁面的 URL 與主頁面不同,簽名對不上自然驗證失敗。把呼叫來源改為主頁面(parent.wx),使用的是主頁面那份已驗證通過的物件,問題即解。子頁面的 canvas 編輯邏輯則不受影響,因為它只是拿主頁面回傳的 localId 來渲染。
不過要誠實地說:微信 JSSDK 看似功能強大,實際 bug 不少,真正用在專案裡常經不起推敲。這個問題解決之後,新問題又來了——canvas 匯出圖片無法跨域。最終這個需求並沒有靠微信的介面實現。
因此更根本的建議是:能避開 iframe 就避開。若一定要用彈窗式編輯體驗,可考慮改用微信原生支援的 wx.previewImage 或自行在同一頁面內以遮罩層呈現編輯器,讓 JSSDK 呼叫與簽名都留在同一個頁面上下文中,能省下大量排查時間。