edit-icon download-icon

Errors and troubleshooting

Last Updated: Mar 20, 2018

The following are some common errors you may experience when using Alibaba Cloud Java SDK. Potential causes and resolutions are shown for these commonly experienced errors.


Error message: Can not resolve endpoint, please check the user guide


The SDK cannot automatically obtain the endpoint of the called product in the specified region.


  1. Obtain the service endpoint of the product in the corresponding API documentation.

  2. Run the following codes to set the endpoint:

    Note: Make sure that the region ID is correct.

    1. DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", "Ecs", "ecs.aliyuncs.com");


Error message: Failed to unmarshal response


SDK response deserialization fails. In most cases, it is because the response structure received by the SDK does not conform to the API metadata. For example, the fields do not match or the format is incorrect.


You can use the client.doAction (request) method to obtain the original HTTP response.


Error message: The request timed out 4 times(3 for retry), perhaps we should have the threshold raised a little?


The request times out and all retry attempts fail.


  • In scenarios such as cross-region calls or low network quality, we recommend that you increase the timeout or the maximum number of retries.

  • If the problem persists and the network quality is confirmed to be good, we recommend that you open a ticket.

SDK.ServerError: InvalidProtocol.NeedSsl

Error message: Your request is denied as lack of ssl protect.Recommend:https://error-center.aliyun.com/status/search?Keyword=InvalidProtocol.NeedSsl&source=PopGw


The API accepts only HTTPS requests so HTTP requests are rejected.


Add the following code before sending a request:

  1. request.setProtocol(ProtocolType.HTTPS)


Submit your problem to Alibaba Cloud through DingTalk group: 11771185, GitHub issue. The SDK R&D team will respond to you as soon as possible.

Thank you! We've received your feedback.