全部產品
Search
文件中心

Alibaba Cloud SDK:重試機制

更新時間:Sep 26, 2025

在V2.0 SDK中,OpenAPI請求處理邏輯內建了網路異常的自動重試機制。當請求因網路問題失敗時,系統會自動重新嘗試,以提升服務的穩定性和可靠性。但對於由商務邏輯引發的錯誤(如參數錯誤、資源不存在等),SDK不會進行重試。這類錯誤通常需要應用程式根據具體的錯誤資訊進行針對性處理或調整,而非簡單重複請求 。本文將為您介紹V2.0 SDK對於網路異常的自動重試機制的配置方式。

重試機制配置方式

說明

重試機制配置優先順序為:RuntimeOptions配置->預設配置,優先順序依次降低。

  • 使用預設配置。預設情況下不會進行重試,如果開啟重試配置且未配置重試次數,則預設最多重試3次。

  • 通過運行時參數(RuntimeOptions)配置重試機制。

    const { RuntimeOptions } = require('@alicloud/tea-util');
    
    // 建立RuntimeOptions執行個體並設定運行參數。
    const runtime = new RuntimeOptions({
      // 設定開啟重試
      autoretry: true,
      // 設定重試次數
      maxAttempts: 3,
    });
    
    import * as $Util from '@alicloud/tea-util';
    
    // 建立RuntimeOptions執行個體並設定運行參數。
    const runtime = new $Util.RuntimeOptions({
      // 設定開啟重試
      autoretry: true,
      // 設定重試次數
      maxAttempts: 3,
    });