當一個非同步任務「可能失敗、失敗就重試、重試超過次數就放棄」時,該怎麼把這套邏輯寫得清楚?Deferred/Promise 搭配一個帶索引的遞迴回呼,是相當常見的解法。
把 callback 風格的 API 包進 Deferred,對外只暴露 Promise,呼叫端就能用鏈式寫法:
function runAsyncTTS(text, speecher, audiopath) {
var def = jQuery.Deferred();
var args = {
"SynthText": text, "VoiceSpeecher": speecher,
"WordSpeed": "3", "UseCSSML": "0", "AudioPath": audiopath
};
tts.asyncTTS(JSON.stringify(args), function(err, result) {
def.resolve(result);
});
return def.promise();
}
這裡有個明顯可改進的點:回呼收到了 err 卻沒有處理。正確做法是在有錯誤時呼叫 def.reject(err),否則呼叫端永遠收不到失敗通知,重試邏輯也就無從判斷。
把多個詞各自組出參數,用 | 串成一整批送出,回傳後再切回陣列:
function textToSpeechBat(metaJson, speecher, audioPath) {
var def = $.Deferred();
var result = { originalWords: "", resultJsonArr: [] };
var jsons = "";
for (var index = 0; index < metaJson.words.length; index++) {
var audioName = metaJson.words[index]['audio'].replace('.mp3', '');
var audioFile = audioPath + "/" + audioName + '.wav';
var args = '{"SynthText": "' + metaJson.words[index]['word'] +
'", "VoiceSpeecher": "' + speecher +
'", "WordSpeed": "3", "UseCSSML": "0", "AudioPath": "' + audioFile + '"}';
jsons += args + "|";
}
jsons = jsons.substr(0, jsons.length - 1); // 去掉尾端的 |
tts.asyncTTSBat(jsons, function(err, ret) {
result['resultJsonArr'] = ret.split('|');
def.resolve(result);
});
return def.promise();
}
用一個帶 index 參數的內部函式遞迴呼叫自己,每失敗一次就 ++index,達到上限便放棄並回傳最後一次結果:
function textToSpeechWithTryTimes(metaJson, speecher, audioPath, times) {
var def = $.Deferred();
var ttsRet = null;
var ttsCallBack = function(index) {
if (index < times) {
textToSpeechBat(metaJson, speecher, audioPath).done(function (ret) {
ttsRet = ret;
var resultJsonArr = ret.resultJsonArr;
var audioFlag = true;
for (var i = 0; i < resultJsonArr.length; i++) {
if (resultJsonArr[i] == "") { audioFlag = false; break; }
var retObj = JSON.parse(resultJsonArr[i]);
if (retObj['audioFlag'] == 'false' || retObj['result'] == "") {
audioFlag = false;
break;
}
}
if (audioFlag == false) {
ttsCallBack(++index); // 失敗,換下一輪
} else {
def.resolve(ret); // 成功,回傳
}
});
}
if (index == times) {
def.resolve(ttsRet); // 次數用盡,回傳最後結果
}
};
ttsCallBack(0);
return def.promise();
}
一是「遞歸次數限制」的檢查位置。if (index == times) 寫在 if (index < times) 區塊之外,但同時又是一個非同步流程——done 的回呼稍後才執行,而外層的判斷早就跑完了。這種「非同步遞迴」用同步的思維寫 if 判斷,很容易出現重複 resolve 或邏輯不觸發的情況。Promise 被 resolve 第二次以後的呼叫會被靜默忽略,症狀是「偶爾沒重試」或「偶爾多跑一次」,非常難查。
二是每次遞迴都重新建立一個 Deferred 並 chain 一次,層數多時容易堆疊。更清楚的寫法是把它攤平成一個迴圈,用 async/await 表達重試:
async function withRetry(fn, times) {
var lastErr;
for (var i = 0; i < times; i++) {
try {
return await fn();
} catch (e) {
lastErr = e;
}
}
throw lastErr;
}
另外建議在重試之間加入遞增的等待時間(指數退避),否則失敗時會在瞬間連續打擊後端服務;同時把每次失敗的原因記錄下來,重試若無可診斷資訊,等於只是在掩蓋問題。