常見問題

問題1：設定訪問憑據環境變數後，仍然無法認證。Cannot read properties of undefined (reading 'getCredential')或”InvalidAccessKeyId.NotFound: code: 404“？

可能的原因是您沒有正確地設定阿里雲的憑證（AccessKey）。

• 錯誤樣本：

 let config = new OpenApi.Config({
      // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
      accessKeyId: process.env['yourAccessKeyID'],
      // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
      accessKeySecret: process.env['yourAccessKeySecret'],
    });

• 正確樣本：

let config = new OpenApi.Config({
      // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
      accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
      // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
      accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
    });

• 檢查您的環境變數中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。

• 在終端（Linux/macOS）或單擊開始（或快速鍵：Win+R）>運行（輸入 cmd）>確定（或按 Enter 鍵），開啟命令提示字元（Windows），執行以下命令。若返回正確的AccessKey，則說明配置成功。如果返回為空白或錯誤，請嘗試重新設定，具體操作請參見設定訪問憑據。

echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

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

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

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

1.網路連接問題

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

解決方案：

• 使用命令ping [www.example.com/192.168.x.x]或curl -Is https://xxx.xxx.xx檢查網路連通性。當遇到網路不通時，應在防火牆或路由器中檢查是否有阻斷策略；對於網路不穩定的情況，建議更換網路環境。

• 通過配置延長逾時時間， 具體操作請參見逾時機制。例如通過配置連線逾時參數來延長連線逾時時間，範例程式碼如下：

  JavaScript樣本

  TypeScript樣本

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

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

2.API處理時間過長

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

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

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

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

問題3：調用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>",
    });

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

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

問題5：使用 npm install 時報錯？

確保 Node.js 和 npm 已正確安裝。使用以下命令清理 npm 緩衝，然後重新安裝。具體操作步驟請參見安裝Node.js。

npm cache clean --force

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

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

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

 rm -rf node_modules package-lock.json
 npm install