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.

SDK.CanNotResolveEndpoint

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

Cause:

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

Resolution:

  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");

SDK.JsonUnmarshalError

Error message: Failed to unmarshal response

Cause:

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.

Resolution:

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

SDK.TimeoutError

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

Cause:

The request times out and all retry attempts fail.

Resolution:

  • 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

Cause:

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

Resolution:

Add the following code before sending a request:

  1. request.setProtocol(ProtocolType.HTTPS)

Others

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.