异常处理 - 适用于 Java 的 AWS 软件开发工具包
为什么使用取消选中的异常？AmazonServiceException (和子类)AmazonClientException
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 客户端代码出现问题。在一般情况下，AmazonClientException 比 AmazonServiceException 严重，前者指示出现严重问题，导致客户端无法对 AWS 服务进行服务调用。例如，如果您在尝试对一个客户端执行操作时网络连接不可用，AWS SDK for Java会引发 AmazonClientException。