微信 JSSDK 的 wx.uploadImage 一次只能處理一張圖片,也就是說多圖上傳必須「一張接一張」地串行執行,無法並行送出。本文示範如何用遞迴把這件事優雅地寫出來,並解決 iOS 上會永遠停在載入狀態的隱藏地雷。
核心思路是:每次取出陣列的第一張,上傳成功後把它移出佇列,再呼叫自己處理下一張;當佇列清空,就代表全部完成,可以關掉 loading 並送出表單。
var serverIds = [];
function uploadImages(localImagesIds) {
// 佇列空了,代表上傳完畢
if (localImagesIds.length === 0) {
$.showPreloader('正在提交數據...');
$('form').submit();
return;
}
wx.uploadImage({
localId: localImagesIds[0], // chooseImage 取得的本地 ID
isShowProgressTips: 1, // 預設 1,顯示進度提示
success: function (res) {
serverIds.push(res.serverId); // 回傳伺服器端 ID
localImagesIds.shift(); // 把已完成的那張移出佇列
uploadImages(localImagesIds); // 遞迴處理下一張
},
fail: function (res) {
$.alert('上傳失敗,請重新上傳!');
}
});
}
使用者點一下預留的 img 元素,就跳出微信的選圖介面。這裡把回傳的 localId 直接寫進 src,一方面做預覽,一方面也方便稍後收集待上傳清單。
$('#uploadImages img').on('click', function () {
var $img = $(this);
wx.chooseImage({
count: 1, // 一次選幾張,預設 9
sizeType: ['original', 'compressed'],// 原圖或壓縮圖,預設兩者皆可
sourceType: ['album', 'camera'], // 相簿或相機,預設兩者皆可
success: function (res) {
var localIds = res.localIds; // 選定照片的本地 ID 清單
$img.attr('src', localIds[0]).addClass('uploaded');
},
fail: function (res) {
alert(JSON.stringify(res));
}
});
});
收集所有已選取的縮圖 src,組成待上傳佇列後丟給 uploadImages,剩下的就交給遞迴一首接一首地傳。
$('#btnSubmit').on('click', function () {
var $chooseImages = $('#uploadImages img.uploaded');
if ($chooseImages.length === 0) {
$.alert('請上傳照片!');
return;
}
$.showPreloader('正在上傳照片...');
var localImagesIds = [];
$chooseImages.each(function () {
localImagesIds.push($(this).attr('src'));
});
uploadImages(localImagesIds);
});
邏輯看起來無懈可擊,Android 實測也完全沒問題,但 iOS 就是卡在上傳階段,畫面一直顯示載入中。反覆檢查程式碼找不到任何毛病——問題出在微信 iOS 端回傳的 localId 格式上。
iOS 版的 chooseImage 有時會回傳以 wxlocalresource 開頭的資源標識,而 wx.uploadImage 期待的是 wxLocalResource 這樣的駝峰寫法。大小寫不一致,於是請求永遠等不到回應。
在上傳前把前綴做一次替換即可,Android 不受影響(因為根本不含這個字串):
var localId = localImagesIds[0]; // 修正 iOS 無法上傳的問題
if (localId.indexOf("wxlocalresource") != -1) {
localId = localId.replace("wxlocalresource", "wxLocalResource");
}
整合後完整的 uploadImages 長這樣:
function uploadImages(localImagesIds) {
if (localImagesIds.length === 0) {
$.showPreloader('正在提交數據...');
$('form').submit();
return;
}
var localId = localImagesIds[0];
// 關鍵修正:把 iOS 回傳的前綴改成 uploadImage 認得的寫法
if (localId.indexOf("wxlocalresource") != -1) {
localId = localId.replace("wxlocalresource", "wxLocalResource");
}
wx.uploadImage({
localId: localId,
isShowProgressTips: 1,
success: function (res) {
serverIds.push(res.serverId);
localImagesIds.shift();
uploadImages(localImagesIds);
},
fail: function (res) {
$.alert('上傳失敗,請重新上傳!');
}
});
}
以上就是微信 JSSDK 多圖串行上傳的完整做法與 iOS 卡住的成因。實務上還建議替遞迴加上失敗重試次數上限,避免某張圖一直失敗造成無限迴圈;同時在全部完成後記得把 serverIds 一併提交給後端。