常见问题

• 确保Java语言环境已经正确安装，Java版本 >= 1.8。

• 确保您的网络能够访问阿里云的API。

• 问题1：运行时，提示“java.lang.NullPointerException: Cannot invoke "java.util.Map...”..."。

• 问题2：运行时，提示“java: 错误：不支持发行版本 X”。

• 问题3：运行时，提示“java: Compilation failed: internal java compiler error”。

• 问题4：运行时，提示“code: 400, is mandatory for this action... ...”

• 问题5：运行时，提示“java.lang.NoSuchMethodError”。

• 问题6：调用API时可能出现超时情况，提示信息包括：“java.net.SocketTimeoutException：connect timed out”、 “java.net.SocketTimeoutException：Read timed out”、 “SDK.ServerUnreachable”、 “Connection aborted”或“RemoteDisconnected”。

• 问题7：运行时，提示“Your request is denied as lack of ssl protect.RequestId ...”。

• 问题8：运行时，提示“code: 404, Specified api is not found, please check your url and method.”。

• 问题9：运行时，提示“Unexpected response code for CONNECT: 400”。

• 问题10：运行时，提示“Specified signature does not match our calculation. server StringToSign is ...”。

• 问题11：运行时提示“Can not set java.lang.String field com.aliyun.imm20200930...”。

• 问题12：IDEA中使用Maven自动下载依赖失败。

• 问题13：NoPermission : You are not authorized to do this operation. Action: xxxx。

• 问题14：使用反射导致的警告（WARNING）信息如何避免。

• 问题15：报错“Specified signature does not match our calculation”。

• 问题16：使用RAM用户请求STS临时签名时，提示：SDK.EndpointResolvingError :” No such region 'cn-XX'. Please check your region ID“。

问题1：运行时，提示“java.lang.NullPointerException: Cannot invoke "java.util.Map.get(Object)" because the return value of "com.aliyun.tea.TeaException.getData()" is null at ...”。

可能是因为您没有正确地设置阿里云的访问密钥（AccessKey）。

 Config config = new Config()
         // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
         .setAccessKeyId(System.getenv("LTAI5tA******"))
         // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
         .setAccessKeySecret(System.getenv("0wpTxkN******"));

Config config = new Config()
        // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
        .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
        // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
        .setAccessKeySecret(System.getenv("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：运行时，提示“java: 错误：不支持发行版本 X”。

同时按下Ctrl+Alt+Shift+S，进入Project Structure窗口。选择Modules，在右侧Language Level中选择跟您所使用JDK版本一致的版本，例如您所使用的JDK 8，Language Level选择“8 - Lambdas, type annotations etc. ”。单击Apply，单击OK。

问题3：运行时，提示“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。

问题4：运行时，提示“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>");

问题5：运行时，提示“java.lang.NoSuchMethodError”。

NoSuchMethodError异常多由依赖包版本冲突造成，主要因为在编译与运行时使用了不同版本的依赖包，类加载器在编译时检索到未定义方法/字段/类。解决方案：

• 若是直接使用jar的用户，可能是某些子级jar未依赖。根据堆栈排查缺失的jar包即可。

• 若是使用maven/gradle等包管理器用户，可能是子级依赖冲突导致项目编译时使用的是低版本的包导致。可根据堆栈排查冲突的依赖并指定高版本即可。

问题6：调用API时可能出现超时情况，提示信息包括：“java.net.SocketTimeoutException：connect timed out”、 “java.net.SocketTimeoutException：Read timed out”、 “SDK.ServerUnreachable”、 “Connection aborted”或“RemoteDisconnected”。

超时问题可能由多种因素引起，以下是一些常见的原因及相应的解决步骤：

网络连接问题

情况描述：客户端与服务器之间的网络不通或网络不稳定导致请求无法到达目标服务器。

解决方案：

• 使用命令ping [www.example.com/192.168.x.x]或curl -Is https://xxx.xxx.xx检查网络连通性。当遇到网络不通时，应在防火墙或路由器中检查是否有阻断策略；对于网络不稳定的情况，建议更换网络环境。

• 通过配置延长超时时间， 具体操作请参见超时机制。例如通过配置连接超时参数来延长连接超时时间，示例代码如下：

// 运行时参数超时设置，仅对使用了该运行时参数实例的请求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.connectTimeout = 5000;

API处理时间过长

情况描述：目标API处理请求的时间超过了设置的读超时时间。

解决方案：通过配置读超时时间来适应较长的API响应时间， 具体操作请参见超时机制。例如通过配置读超时时间参数来延长当前请求的读超时时间，示例代码如下：

// 运行时参数超时设置，仅对使用了该运行时参数实例的请求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.readTimeout = 10000;

问题7：运行时，提示“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协议。

问题8：运行时，提示“code: 404, Specified api is not found, please check your url and method.”。

此类错误的直接原因可能是您在调用某产品API时，填写了错误的Endpoint或RegionId。解决方法如下：

确保您所选区域支持您正在调用的服务。产品的Endpoint可以通过OpenAPI 开发者门户的产品主页中进行查找，这里以短信服务为例。

问题9：运行时，提示“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。

• 可能被内网防火墙拦截，本地环境可尝试切换网络环境测试，例如连接移动网络热点。

问题10：运行时，提示“Specified signature does not match our calculation. server StringToSign is ...”。

此问题直接原因为客户端签名参数和服务端计算得到签名参数不匹配导致报错。解决方案：

在绝大多数场景中，用户SK填写信息存在错误，因此应首先重新生成一版新的AK，然后再进行后续的排查。

• 升级SDK子级依赖openapiutil到最新版本。

• 通过抓取请求包，检查网络层面是否遭遇字段拦截。

• 代码调试，检查客户端是否存在特殊字符导致的转码异常。

• 检查以下依赖包版本是否过低。

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

• 检查是否在并发场景重新new request，request并不线程安全。

问题11：运行时，提示“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>

问题12：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“正确配置。

问题13：NoPermission : You are not authorized to do this operation. Action: xxxx。

此问题的直接原因在于未为调用所属账号授予所需API的权限。解决方案：

1. 权限诊断：使用诊断平台进行权限检查。请登录OpenAPI自助诊断进行排查。

2. 权限授予：检查调用所属账号是否具有所调用API的权限，如果没有权限则需要为其授予相应的API权限。具体操作，请参见为RAM用户授权。

3. 权限验证：授权完成后，请重新尝试执行原操作，确认权限已正确授予所属账号。

问题14：使用反射导致的警告（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级别或更高的日志信息。

问题15：报错“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

问题16：使用RAM用户请求STS临时签名时，提示：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'
}

以上问题的解决方案旨在帮助您更友好地使用阿里云SDK。如果您在使用过程中遇到其他问题，请通过以下方式与我们联系：

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

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