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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

异常处理

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

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

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

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

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

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

有关使用选中和取消选中的异常的更多信息,请参阅:

AmazonServiceException(和子类)

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

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

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

  • 返回的 HTTP 状态代码

  • 返回的 AWS 错误代码

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

  • 已失败请求的 AWS 请求 ID

AmazonServiceException 中还包括相关信息,指出请求失败原因是调用方的错误(请求的值非法),还是 AWS 服务的错误(内部服务错误)。

AmazonClientException

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