Alibaba Cloud SDK：常見問題

• 確保Java語言環境已經正確安裝，Java版本 >= 1.8。

• 確保您的網路能夠訪問阿里雲的API。

• AK傳參問題。

• code 403，You are not authorized to do this operation. Action: xxxx。

• 問題3：com.aliyun.XX.XX 導包無效。

• java.lang.NoSuchMethodError: com.aliyun.credentials.Client.getCredential()Lcom/aliyun/credentials/models/CredentialModel。

• java: 錯誤：不支援發行版本 X。

• java: Compilation failed: internal java compiler error。

• code: 400, is mandatory for this action。

• java.lang.NoSuchMethodError。

• java.net.SocketTimeoutException：connect timed out”、 “java.net.SocketTimeoutException：Read timed out”、 “SDK.ServerUnreachable”、 “Connection aborted”或“RemoteDisconnected。

• Your request is denied as lack of ssl protect.RequestId 。

• code: 404, Specified api is not found, please check your url and method。

• Unexpected response code for CONNECT: 400。

• Specified signature does not match our calculation. server StringToSign is XXX。

• Can not set java.lang.String field com.aliyun.imm20200930。

• IDEA中使用Maven自動下載依賴失敗。

• 使用反射導致的警告（WARNING）資訊如何避免。

• Specified signature does not match our calculation。

• SDK.EndpointResolvingError :” No such region 'cn-XX'. Please check your region ID。

• Failed to instantiate [com.aliyuncs.IAcsClient]: Factory method 'iAcsClient' threw exception with message: org/apache/http/conn/ssl/DefaultHostnameVerifier 。

• 調用OpenAPI介面時報錯 code: 4θ1, You have not activated the XXX service 或類似提示。

問題1：AK傳參問題。

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

• V2.0 SDK：Cannot invoke "com.aliyun.credentials.Client.getCredential()" because "this._credential" is null”

• V1.0 SDK：ErrCode:MissingAccessKeyId.ErrMsg:AccessKeyId is mandatory for this action。

解決方案：

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相關內容是否存在錯誤。

   常見的錯誤樣本：

   Config config = new Config()
            .setAccessKeyId(System.getenv("yourAccessKeyID"))   
            .setAccessKeySecret(System.getenv("yourAccessKeySecret")); 

   正確樣本：

   Config config = new Config()
           .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
           .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

   說明

   System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")和System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")，表示的是從環境變數中擷取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。

   重要

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

問題2：code 403，You are not authorized to do this operation. Action: xxxx。

此問題的直接原因在於調用API的RAM使用者、角色或使用者組未被授予 XXXX 許可權（錯誤資訊中的 Action 值）。Action:XXXX（如Action:dysms:SendSms）其中dysms:SendSms表示當前帳號所需的具體API許可權。其格式為：<服務縮寫>:<API名稱>。在此樣本中dysms:SendSms表示需要簡訊服務的SendSmsAPI許可權。

解決方案：

1. 許可權診斷：使用診斷平台進行許可權檢查。請登入OpenAPI自助診斷進行排查。

2. 許可權授予：請檢查調用RAM使用者、角色或使用者組是否具備所調用API的許可權。如果未獲得相應許可權，則需為其授予相應的API許可權。具體操作，請參見權限原則。

3. 許可權驗證：授權完成後，請重新嘗試執行原操作（許可權變更通常需 1~5分鐘生效），以確認許可權已正確授予相關帳號。

問題3：com.aliyun.XX.XX 導包無效。

import com.aliyun.teaopenapi.Client; // 提示：The import com.aliyun.XXX cannot be resolved。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>tea-openapi</artifactId>
    <version>0.3.8</version>
</dependency>

問題4：java.lang.NoSuchMethodError: com.aliyun.credentials.Client.getCredential()Lcom/aliyun/credentials/models/CredentialModel。

問題5：java: 錯誤：不支援發行版本 X。

同步選取Ctrl+Alt+Shift+S，進入Project Structure視窗。選擇Modules，在右側Language Level中選擇跟您所使用JDK版本一致的版本，例如您所使用的JDK 8，Language Level選擇“8 - Lambdas, type annotations etc. ”。單擊Apply，單擊OK。

問題6：java: Compilation failed: internal java compiler error。

在IntelliJ IDEA功能表列，單擊File->Settings->Build, Execution, Deployment->Compiler->Java Compiler，Project bytecode version和Target bytecode version選擇跟您所使用JDK版本一致的版本，例如您所使用的JDK 8，這兩項選擇 8 即可。單擊Apply，單擊OK。

問題7：code: 400, <CERTAIN_FIELD > is mandatory for this action。

此問題的直接原因在於在調用API時未填寫必填參數。解決方案：

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

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

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

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

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

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

SendSmsRequest sendSmsRequest = new SendSmsRequest()
        //需要替換成為您接收簡訊的手機號碼
        .setPhoneNumbers("<YOUR_VALUE>")
        //需要替換成為您的簡訊簽名
        .setSignName("<YOUR_VALUE>")
        //需要替換成為您的簡訊模板code
        .setTemplateCode("<YOUR_VALUE>");

問題8：java.lang.NoSuchMethodError。

NoSuchMethodError異常多由依賴包版本衝突造成，主要因為在編譯與運行時使用了不同版本的依賴包，類載入器在編譯時間檢索到未定義方法/欄位/類。解決方案：

• 若是直接使用jar的使用者，可能是某些子級jar未依賴。根據堆棧排查缺失的jar包即可。

• 若是使用maven/gradle等包管理器使用者，可能是子級依賴衝突導致專案編譯時間使用的是低版本的包導致。可根據堆棧排查衝突的依賴並指定高版本即可。

問題9：java.net.SocketTimeoutException：connect timed out”、 “java.net.SocketTimeoutException：Read timed out”、 “SDK.ServerUnreachable”、 “Connection aborted”或“RemoteDisconnected”。

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

網路連接問題

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

解決方案：

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

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

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

// 運行時參數逾時設定，僅對使用了該運行時參數執行個體的請求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.connectTimeout = 5000;

API處理時間過長

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

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

// 運行時參數逾時設定，僅對使用了該運行時參數執行個體的請求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.readTimeout = 10000;

問題10：Your request is denied as lack of ssl protect.RequestId 。

此問題是由於介面要求使用HTTPS協議進行調用，而您可能使用了原版JavaSDK，採用了HTTP協議進行調用。解決方案：

• V1.0 SDK 可以通過對 Request 對象佈建要求通過 HTTPS 協議發送：

  request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);

• 使用V2.0SDK，V2.0SDK預設使用HTTPS協議。

問題11：code: 404, Specified api is not found, please check your url and method。

此類錯誤的直接原因可能是您在調用某產品API時，填寫了錯誤的Endpoint或RegionId。解決方案如下：

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

問題12：Unexpected response code for CONNECT: 400。

此問題直接原因為請求未發送到阿里雲網關，被中間節點截斷。解決方案：

• 可能是代理配置錯誤，例如您配置的是setHttpProxy，V2.0 SDK預設發送HTTPS請求，即代理不生效會引發此報錯。可通過配置協議類型為HTTP嘗試解決，config.protocol = "HTTP"。

• 可能代理服務配置錯誤，即代理服務無法正確轉寄請求到阿里雲網關，可通過curl檢查代理配置是否正確。curl https://<阿里雲服務網域名稱>/ -v -x <代理IP/代理網域名稱>:<代理連接埠>，例如curl https://ecs-cn-hangzhou.aliyuncs.com/ -v -x 127.0.0.1:3128。

• 可能被內網防火牆攔截，本地環境可嘗試切換網路環境測試，例如串連移動網路熱點。

問題13：Specified signature does not match our calculation. server StringToSign is XX。

此問題直接原因為用戶端簽名參數和服務端計算得到簽名參數不匹配導致報錯。解決方案：

在絕大多數情境中，使用者SK填寫資訊存在錯誤，因此應首先重建一版新的AK，然後再進行後續的排查。

• 升級SDK子級依賴openapiutil到最新版本。

• 通過抓取請求包，檢查網路層面是否遭遇欄位攔截。

• 代碼調試，檢查用戶端是否存在特殊字元導致的轉碼異常。

• 檢查以下依賴包版本是否過低。

   <dependency>
     <groupId>commons-codec</groupId>
     <artifactId>commons-codec</artifactId>
     <version>1.15</version>
   </dependency>

• 檢查是否在並發情境重新new request，request並不安全執行緒。

問題14：Can not set java.lang.String field com.aliyun.imm20200930.models.GenerateWebofficeTokenShrinkRequest.userShrink to java.util 。

此問題直接原因為低版本Tea包無法將複雜結構轉化為String結構導致報錯。解決方案：

升級Tea包到1.2.7及以上。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>tea</artifactId>
  <version>1.2.7</version>
</dependency>

問題15：IDEA中使用Maven自動下載依賴失敗。

• 更新Maven倉庫

  開啟”File“菜單，選擇”Settings“（或”Preferences“）。左側導覽列中，展開“Build, Execution, Deployment”，然後選擇“Build Tools” > “Maven”。找到“Repositories”選項卡，選擇本地倉庫，點擊“Update”按鈕，等待更新完成。

• 檢查IDEA緩衝

  開啟“File”菜單，選擇“Invalidate Caches…”，在彈出的對話方塊中，選擇“Invalidate and Restart”，等待IDEA清理緩衝並重新啟動。

  

• 檢查網路連結

  如果Maven無法串連到中央倉庫或其他遠程倉庫，它可能會無法下載依賴項。確保您的網路連接正常，並且沒有任何防火牆或Proxy 伺服器阻止Maven的訪問。

• 檢查Maven配置

  檢查Maven設定檔（通常是settings.xml）是否正確配置。確保”localRepository“指向正確的本地倉庫路徑，”mirrors”、”proxies“、”profiles“正確配置。

問題16：使用反射導致的警告（WARNING）資訊如何避免。

在阿里雲 SDK 的使用中，當使用較高版本的JDK進行開發時，可能會遇到與反射相關的警告資訊，這些警告資訊可能影響程式的輸出，尤其是當您希望在生產環境中避免不必要的日誌資訊時。

解決方案：

您可以通過設定環境變數 ALIBABA_CLOUD_SDK_LOG_LEVEL 將記錄層級調整為 ERROR，以抑制警告資訊的顯示。操作步驟：

1. 設定環境變數：

   Windows

   set ALIBABA_CLOUD_SDK_LOG_LEVEL=ERROR

   Linux/macOS

   export ALIBABA_CLOUD_SDK_LOG_LEVEL=ERROR

2. 確認環境變數設定：

   Windows

   echo %ALIBABA_CLOUD_SDK_LOG_LEVEL%

   Linux/macOS

   echo $ALIBABA_CLOUD_SDK_LOG_LEVEL

3. 啟動您的應用程式：在您配置好環境變數後，啟動您的 Java 應用程式。此時，阿里雲 SDK 產生的警告資訊將不會被顯示，您只會看到ERROR層級或更高的日誌資訊。

問題17：Specified signature does not match our calculation。

此問題直接原因通常是由於請求的簽名與伺服器計算的簽名不匹配引起的。可能的原因包括：

• Access Key (AK) 複製錯誤

• 簽名演算法不正確

• 檢查請求參數及其順序是否符合API要求。

確保在代碼中設定的Access Key和Secret Key與您在控制台上擷取的完全一致。檢查是否有多餘的空格或者特殊字元。解決方案：

升級commons-codec版本，以避免潛在的簽名計算錯誤：

更新依賴：

   <dependency>
       <groupId>commons-codec</groupId>
       <artifactId>commons-codec</artifactId>
       <version>1.15</version> <!-- 更新後的版本 -->
   </dependency>

mvn clean install

dependencies {
     implementation 'commons-codec:commons-codec:1.15' // 更新後的版本
}

gradle build

問題18：SDK.EndpointResolvingError :” No such region 'cn-XX'. Please check your region ID“。

此問題直接原因是由於SDK版本過低導致無法支援新地區或介面的調用，解決方案：

升級SDK依賴版本：

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.7.2</version>
</dependency>

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-sts</artifactId>
  <version>3.1.2</version>
</dependency>

dependencies {
    implementation 'com.aliyun:aliyun-java-sdk-core:4.7.2'
    implementation 'com.aliyun:aliyun-java-sdk-sts:3.1.2'
}

問題19：Failed to instantiate [com.aliyuncs.IAcsClient]: Factory method 'iAcsClient' threw exception with message: org/apache/http/conn/ssl/DefaultHostnameVerifier 。

此問題的直接原因是使用阿里雲 SDK 的過程中，使用了不相容版本的 Apache HttpClient 庫，從而導致了錯誤。解決方案：

• 如果專案使用了多個依賴庫，確保沒有其他庫引入不相容的 HttpClient 版本。通過手動檢查或使用構建工具的依賴管理功能來審查。

• Apache HttpClient 版本過低，建議更新至4.5.14及以上版本。

     <dependency>
         <groupId>org.apache.httpcomponents.client</groupId>
         <artifactId>httpclient</artifactId>
         <version>4.5.14</version> <!-- 請檢查最新版本 -->
     </dependency>

問題20：調用OpenAPI介面時報錯 code: 4θ1, You have not activated the XXX service 或類似提示。

該錯誤表示當前使用的阿里雲帳號尚未開通或啟用對應的某項服務。其中 XXX 表示具體的服務名稱，如 OCR service 等。解決方案：

1. 登入對應服務的管理主控台。

2. 尋找並開通所需能力。

3. 等待服務開通生效後重新調用介面。

以上問題的解決方案旨在協助您更友好地使用阿里雲SDK。如果您在使用過程中遇到其他問題，請通過以下方式與我們聯絡：

• 提交工單：阿里雲提交工單頁面。

• 如果您有相關需求或反饋，可以添加DingTalk群聯絡阿里雲技術支援人員，群號為60965016010。