DIV CSS 佈局教程網

JavaScript Deferred 與遞歸重試次數限制的實戰解析
編輯:JavaScript綜合知識     

異步任務失敗後自動重試,是對接不穩定服務時的標配需求。但直接用遞歸重試有個致命問題——沒有次數上限時會無限循環。這裡用 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),成功率反而更高。生產環境還可以引入指數退避加隨機抖動。

日誌帶上下文。打印第幾次嘗試、具體錯誤信息,排查問題時能省下大量時間。

異步重試的核心要點始終是這三條:有上限、有間隔、有日誌。工具在變,原則不變。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved