異步任務失敗後自動重試,是對接不穩定服務時的標配需求。但直接用遞歸重試有個致命問題——沒有次數上限時會無限循環。這裡用 jQuery Deferred 封裝一套帶重試上限的異步調用方案,場景是文字轉語音的批量合成。
先把異步 API 包成 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(); // 只暴露只讀的 promise
}
這裡有個關鍵設計:返回 def.promise() 而不是 def 本身。Deferred 對象同時包含 resolve/reject 這些「控制端」方法,如果直接返回,調用方就能隨意改變狀態。只暴露 promise 只有 done/fail/then 這些「消費端」方法,保證了封裝的完整性。
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();
}
用豎線拼接多條任務一次提交,能顯著減少網絡往返次數。返回結果再按同樣的分隔符切回數組,形成對稱的序列化約定。
這是全篇的重點。遞歸函數 ttsCallBack 帶一個 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) {
console.log("第 " + (index + 1) + " 次失敗,重試");
ttsCallBack(++index); // 遞歸重試
} else {
console.log("成功,返回結果");
def.resolve(ret);
}
});
}
// 達到上限:放棄並返回最後一次的結果
if (index == times) {
console.log("已達最大重試次數,返回");
def.resolve(ttsRet);
}
};
ttsCallBack(0);
return def.promise();
}
遞歸必須有明確的出口,否則必然棧溢出。這裡的出口是 index == times:index 從 0 開始,每次失敗遞增,達到上限後 if(index < times) 不再成立,遞歸自然停止,同時由 index == times 分支負責收尾 resolve。兩個判斷互為互補,構成完整的狀態機。
這段代碼寫於 Deferred 時代,今天用 async/await 會清晰很多:
const sleep = ms => new Promise(r => setTimeout(r, ms));
async function withRetry(task, times = 3, delay = 500) {
let lastError;
for (let attempt = 1; attempt <= times; attempt++) {
try {
return await task(); // 成功直接返回
} catch (err) {
lastError = err;
console.warn(`第 ${attempt} 次失敗:`, err.message);
if (attempt < times) {
await sleep(delay * attempt); // 遞增退避
}
}
}
throw lastError; // 全部失敗才拋錯
}
// 使用
const result = await withRetry(
() => textToSpeechBat(metaJson, speecher, audioPath),
3
);
相比原版,async/await 版本有幾個實質改進:
用循環代替遞歸。重試本質是重複而非嵌套,用 for 表達更貼合語義,也不必擔心調用棧增長。
區分 resolve 與 reject。原版無論成功失敗都調 resolve,調用方無法用 .fail() 區分,只能靠檢查返回值內容。規範做法應該是失敗時 reject。
加入遞增退避。連續高頻重試往往會加劇服務端壓力。讓每次重試間隔逐次拉長(delay * attempt),成功率反而更高。生產環境還可以引入指數退避加隨機抖動。
日誌帶上下文。打印第幾次嘗試、具體錯誤信息,排查問題時能省下大量時間。
異步重試的核心要點始終是這三條:有上限、有間隔、有日誌。工具在變,原則不變。