Alibaba Cloud SDK：常見問題

問題1：AK傳參問題。

問題現象：代碼運行時報錯，報錯資訊中包含如下資訊時，表示AK未正確地設定阿里雲的憑證（AccessKey）。

• V2.0 SDK：Cannot read properties of undefined (reading 'getCredential').

• V1.0 SDK：AssertionError [ERR_ASSERTION]: must pass "config.accessKeyId".

解決方案：

1. 執行以下命令，檢查您的環境變數中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET：

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   若返回正確的AccessKey，則說明配置成功。如果返回為空白或錯誤，請嘗試重新設定，具體操作請參見在Linux、macOS和Windows系統配置環境變數。

2. 檢查代碼中AK相關內容是否存在錯誤。

   常見的錯誤樣本：

    let config = new OpenApi.Config({
         accessKeyId: process.env['yourAccessKeyID'],
         accessKeySecret: process.env['yourAccessKeySecret'],
       });

   正確樣本：

   let config = new OpenApi.Config({
         accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
         accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });

   說明

   process.env['ALIBABA_CLOUD_ACCESS_KEY_ID']和process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET']

   ，表示是從環境變數中擷取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。

   重要

   切勿直接線上上代碼中明文寫入 AccessKey，該寫法存在安全隱患。

問題2：在執行tsc命令時，提示tsc : 無法將“tsc”項識別為cmdlet、函數、指令檔或可執行程式的名稱...。

問題3：調用API逾時，提示：”Error: connect ETIMEDOUT“？

逾時的常見原因與解決步驟：

逾時問題可能由多種因素引起，以下是一些常見的原因及相應的解決步驟：

1.網路連接問題

情況描述：用戶端與伺服器之間的網路不通或網路不穩定導致請求無法到達目標伺服器。

解決方案：

使用ping或curl命令測試本地主機與雲產品Endpoint之間連通性，例如調用傳送簡訊介面逾時時，使用ping dysmsapi.aliyuncs.com或curl -v https://dysmsapi.aliyuncs.com測試連通性。

• 若命令執行逾時或者無響應，請檢查本地防火牆或路由器中是否有阻斷策略。

• 若命令有響應，建議設定合理的逾時時間，避免因配置不當導致請求失敗，具體操作請參見逾時機制。範例程式碼如下：

  JavaScript樣本

  // 建立RuntimeObject執行個體並設定運行參數。
      const runtime = new RuntimeOptions({
          // 設定連線逾時時間
          connectTimeout: 10000,
      });

  TypeScript樣本

   // 建立RuntimeObject執行個體並設定運行參數。
          const runtime = new $Util.RuntimeOptions({
              // 設定連結逾時時間
              connectTimeout: 10000,
          });

2.API處理時間過長

情況描述：目標API處理請求的時間超過了設定的讀逾時時間。

解決方案：通過配置或增加逾時時間來適應較長的API回應時間， 具體操作請參見逾時機制。例如通過配置讀逾時時間參數來延長當前請求的讀逾時時間，範例程式碼如下：

// 建立RuntimeObject執行個體並設定運行參數。
    const runtime = new RuntimeOptions({
        // 設定讀取逾時時間
        readTimeout: 10000,
    });

 // 建立RuntimeObject執行個體並設定運行參數。
        const runtime = new $Util.RuntimeOptions({
            // 設定讀取逾時時間
            readTimeout: 10000,
        });

問題4：調用API時發生”MissingRequiredParameter“類型錯誤？

這裡以調用簡訊服務的傳送簡訊介面為例：

• 進入OpenAPI門戶的API調試頁面，選擇雲產品和介面。

• 仔細對比構造的請求對象（如 SendSmsRequest）是否填充了所有必需欄位，例如手機號、簽名等。

• 參考API文檔確認必填項。確保必填參數值正確。

• 確保填寫的必填參數值正確無誤，例如手機號格式是否符合要求。

• 在調用 API 前，SDK 會對參數進行自動校正。如果缺少必要參數，您將收到類似 MissingRequiredParameter 的錯誤提示。例如，如果手機號參數缺失，會報錯 “MissingPhoneNumbers: code: 400”。

let sendSmsRequest = new Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: '<YOUR_VALUE>',
      signName: '<YOUR_VALUE>',
      templateCode: '<YOUR_VALUE>',
    });

let sendSmsRequest = new $Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: "<YOUR_VALUE>",
      signName: "<YOUR_VALUE>",
      templateCode: "<YOUR_VALUE>",
    });

問題5：API 呼叫失敗，提示地區不支援，報錯”getaddrinfo ENOTFOUND“系統無法找到指定的主機名稱？

確保您所選地區支援您正在調用的服務。這裡以簡訊服務為例，查看產品的Endpoint可以通過OpenAPI 開發人員門戶的產品首頁中進行尋找確認，請確保填寫正確的Endpoint。

問題6：安裝SDK時， npm install 報錯？

首先確保 Node.js 和 npm 已正確安裝，具體操作步驟請參見安裝Node.js。

問題7：依賴包版本出現衝突？

• 使用npm ls命令查看依賴樹，確保沒有版本衝突。

• 可以刪除node_modules目錄和package-lock.json檔案，並重新安裝依賴：

 rm -rf node_modules package-lock.json
 npm install