萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Deferred 與遞歸重試機制:非同步語音合成批次處理實戰

背景場景

語音合成(TTS)服務需批次處理多筆文字,單次請求可能失敗,需實作「重試 N 次直到成功或達上限」的非同步流程控制。使用 jQuery Deferred 物件管理 Promise 狀態,搭配遞歸回調實現重試邏輯。

核心模組拆解

1. 單筆 TTS 非同步呼叫

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,支援 .done()/.fail()
}

2. 批次 TTS 處理

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();
}

3. 帶重試次數限制的遞歸包裝

function textToSpeechWithTryTimes(metaJson, speecher, audioPath, times) {
    var def = $.Deferred();
    var ttsRet = null;
    
    // 遞歸回調函式
    var ttsCallBack = function(index) {
        if (index < times) {
            // 呼叫批次 TTS
            textToSpeechBat(metaJson, speecher, audioPath).done(function(ret) {
                console.log("嘗試 " + (index + 1) + ": " + JSON.stringify(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;
                    }
                }
                
                console.log("本次結果:", audioFlag ? "成功" : "失敗");
                
                if (audioFlag === false) {
                    // 失敗:遞歸重試,索引 +1
                    console.log("重試中...");
                    ttsCallBack(++index);
                } else {
                    // 成功:resolve 最終結果
                    console.log("成功完成");
                    def.resolve(ret);
                }
            });
        }
        
        // 達到最大重試次數仍失敗
        if (index === times) {
            console.log("重試次數耗盡,回傳最後結果");
            def.resolve(ttsRet);
        }
    };
    
    ttsCallBack(0); // 從第 0 次開始
    return def.promise();
}

關鍵設計模式解析

Deferred/Promise 模式

  • $.Deferred() 建立延遲物件,掌控解析/拒絕時機
  • def.promise() 回傳受限 Promise,外部只能 .done()/.fail(),不可手動 resolve
  • 非同步回呼中呼叫 def.resolve() 觸發後續鏈式處理

遞歸重試模式


// 通用重試包裝器(現代 Promise 寫法)
function retry(fn, maxAttempts, delayMs = 1000) {
    return fn().catch(function(err) {
        if (maxAttempts <= 1) throw err;
        console.log("重試剩餘:", maxAttempts - 1);
        return new Promise(r => setTimeout(r, delayMs))
            .then(() => retry(fn, maxAttempts - 1, delayMs * 2)); // 指數退避
    });
}

// 使用範例
retry(() => textToSpeechBat(metaJson, speecher, audioPath), 3)
    .then(result => console.log("最終成功:", result))
    .catch(err => console.error("全部失敗:", err));

遞歸深度與堆疊安全

JavaScript 引擎對遞歸深度有限制(通常 ~10,000~15,000 層)。本範例重試次數通常 < 10,安全無虞。若需大量遞歸,請改用迴圈 + Promise 鏈或 async/await 避免堆疊溢位。

錯誤處理強化建議

  1. 加入 .fail() 處理網路錯誤:textToSpeechBat(...).fail(() => ttsCallBack(++index))
  2. 超時控制:使用 Promise.race() 包裝請求與 setTimeout
  3. 指數退避:重試間隔逐漸增加,避免壓垮服務
  4. 冪等性:確保重試請求可安全重複執行

總結

Deferred 物件提供強大的非同步流程控制能力,配合遞歸回調可優雅實作重試機制。現代專案建議遷移至原生 Promise + async/await,程式碼更線性、易除錯、易維護。

copyright © 萬盛學電腦網 all rights reserved