适用于 Java 的 AWS 开发工具包
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

异常处理

要使用开发工具包构建高质量的应用程序,必须了解 AWS SDK for Java 在什么情况下会引发异常以及它以什么方式引发异常。接下来几节介绍开发工具包引发异常的几种不同情况,以及如何正确地处理这些异常。

为什么使用取消选中的异常?

出于以下原因,AWS SDK for Java 使用运行时 (或取消选中的) 异常而不是选中的异常:

  • 使开发人员能够精细控制要处理哪些错误,而不是必须处理无关紧要的异常情况 (这会导致代码极其冗长)

  • 避免大型应用程序因使用选中的异常而固有的可扩展性问题

一般来说,小型应用程序使用选中的异常是可以的,但随着应用程序的大小和复杂程度增加,这样做就会出现问题。

SdkServiceException(和子类)

SdkServiceException 是在使用 AWS SDK for Java 时最常遇到的异常。该异常是指来自 AWS 服务的错误响应。例如,如果您尝试终止不存在的 Amazon EC2 实例,EC2 会返回错误响应,而且引发的 SdkServiceException 中会包含该错误响应的所有详细信息。在某些情况下,会引发 SdkServiceException 的一个子类,使开发人员能够通过捕获模块精细控制如何处理错误情况。

当您遇到 SdkServiceException 时,您就会知道,您的请求已成功发送到 AWS 服务,但无法成功处理。这可能是因为请求的参数中存在错误,或者是因为服务端的问题。

SdkServiceException 为您提供很多信息,例如:

  • 返回的 HTTP 状态代码

  • 返回的 AWS 错误代码

  • 来自服务的详细错误消息

  • 已失败请求的 AWS 请求 ID

SdkServiceException 还包括 ErrorType 字段,此字段指出请求失败原因是调用方的错误(请求具有非法值)还是 AWS 服务的错误(内部服务错误)。

SdkClientException

SdkClientException 指示在尝试将请求发送到 AWS 或者在尝试解析来自 AWS 的响应时,Java 客户端代码内出现问题。在一般情况下,SdkClientExceptionSdkServiceException 严重,前者指示出现严重问题,导致客户端无法对 AWS 服务进行服务调用。例如,如果您在尝试对一个客户端执行操作时网络连接不可用,AWS SDK for Java 会引发 SdkClientException