全部產品
Search
文件中心

Alibaba Cloud SDK:逾時機制

更新時間:Oct 14, 2025

在軟體開發中,配置逾時時間是為了防止程式因等待響應而長時間陷入阻塞狀態。如果未進行配置,可能會導致資源浪費甚至系統崩潰;而若設定的逾時時間過短,則可能在任務尚未完成時便中斷,從而影響正常功能。因此,合理設定逾時時間能夠提升系統的穩定性與使用者體驗。本文將介紹V2.0 Node.js SDK的逾時配置方法。

逾時配置方式

說明

逾時機制優先順序為:RuntimeOptions設定 -> Config設定 -> 預設配置,優先順序依次降低。

  • 使用預設配置。預設連線逾時為5000毫秒,讀逾時為10000毫秒。

  • 通過運行時參數(RuntimeOptions)配置當前請求的逾時時間。

    const { RuntimeOptions } = require('@alicloud/tea-util');
    
    // 建立RuntimeOptions執行個體並設定運行參數。
    const runtime = new RuntimeOptions({
      // 設定連線逾時時間
      connectTimeout: 10000,
      // 設定讀取逾時時間
      readTimeout: 10000,
    });
        
    import * as $Util from '@alicloud/tea-util';
    
    // 建立RuntimeOptions執行個體並設定運行參數。
    const runtime = new $Util.RuntimeOptions({
      // 設定連線逾時時間
      connectTimeout: 10000,
      // 設定讀取逾時時間
      readTimeout: 10000,
    });
    
  • 通過Config配置全域逾時時間。

    const { Config } = require('@alicloud/openapi-client');
    
    const config = new Config({
      // 設定連線逾時時間
      connectTimeout: 10000,
      // 設定讀取逾時時間
      readTimeout: 10000,
    });
    
    import * as $OpenApi from '@alicloud/openapi-client';
    
    const config = new $OpenApi.Config({
      // 設定連線逾時時間
      connectTimeout: 10000,
      // 設定讀取逾時時間
      readTimeout: 10000,
    });