阿里云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无法连接到中央仓库或其他远程仓库，它可能会无法下载依赖项。确保您的网络连接正常，并且没有任何防火墙或代理服务器阻止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。如果您在使用过程中遇到其他问题，请通过以下方式与我们联系：

• 提交工单：阿里云提交工单页面。

• 如果您有相关需求或反馈，可以添加钉钉群联系阿里云技术支持人员，群号为60965016010。