AWS SDK for Java 2.x에서 오류 처리 - AWS SDK for Java 2.x
확인되지 않은 예외가 발생하는 이유AwsServiceException(및 하위 클래스)SdkClientException예외 및 재시도 동작

AWS SDK for Java 2.x에서 오류 처리

AWS SDK for Java 2.x에서 예외가 언제 어떻게 발생하는지를 이해하는 것은 SDK를 사용하여 고품질의 애플리케이션을 빌드하는 데 있어서 중요합니다. 다음 단원에서는 SDK에서 발생하는 다양한 예외의 경우와 이러한 예외를 적절히 처리하는 방법에 대해 설명합니다.

확인되지 않은 예외가 발생하는 이유

AWS SDK for Java에서는 다음과 같은 이유로 확인된 예외 대신에 실행시간 (또는 확인되지 않은) 예외를 사용합니다.

  • 개발자가 중요하지 않은 예외 경우를 강제로 처리하지 않고 (또한 해당 코드를 상세 표시 모드로 설정하지 않고) 처리하고자 하는 오류에 대해서만 세부적으로 제어할 수 있도록 하기 위해

  • 대규모 애플리케이션에서 확인된 예외 고유의 확장성 문제를 방지하기 위해

일반적으로 확인된 예외는 소규모 애플리케이션에서 잘 작동하는 편이지만, 애플리케이션이 확장되고 복잡해짐에 따라 문제가 될 수도 있습니다.

AwsServiceException(및 하위 클래스)

AwsServiceException은 AWS SDK for Java를 사용할 때 발생하는 가장 일반적인 예외입니다. AwsServiceException는 보다 일반적인 SdkServiceException의 서브클래스입니다. AwsServiceException는 AWS 서비스의 오류 응답을 나타냅니다. 예를 들어 존재하지 않는 Amazon EC2 인스턴스를 종료하려고 할 경우 Amazon EC2는 오류 응답을 반환하며 해당 오류 응답에 대한 모든 세부 정보가 발생된 AwsServiceException에 포함됩니다.

AwsServiceException이 발생하면 요청이 AWS 서비스로 전송되었지만 처리되지 못했음을 의미합니다. 이는 요청의 파라미터 오류 또는 서비스 측의 문제로 인해 발생할 수 있습니다.

AwsServiceException은 다음과 같은 정보를 제공합니다.

  • 반환된 HTTP 상태 코드

  • 반환된 AWS 오류 코드

  • AWSerrorDetails 클래스에 있는 서비스의 자세한 오류 메시지

  • 실패한 요청의 AWS 요청 ID

경우에 따라서는 개발자가 catch 블록을 통해 오류 경우 처리를 세부적으로 제어할 수 있도록 하기 위해 AwsServiceException의 하위 클래스가 발생하기도 합니다. AwsServiceException에 대한 Java SDK API 참조에는 많은 수의 AwsServiceException 서브클래스가 표시됩니다. 서브클래스 링크를 사용하여 서비스에서 발생하는 세분화된 예외를 자세히 확인할 수 있습니다.

예를 들어 SDK API 참조에 대한 다음 링크는 몇 가지 일반적인 AWS 서비스에 대한 예외 계층 구조를 보여줍니다. 각 페이지에 표시된 서브클래스 목록은 코드가 포착할 수 있는 특정 예외를 보여줍니다.

예외에 대해 자세히 알아보려면 AwsErrorDetails 객체의 errorCode를 살펴보세요. 이 errorCode 값을 사용하여 서비스 가이드 API에서 정보를 조회할 수 있습니다. 예를 들어 S3Exception가 InvalidRequest 발견되었는데 AwsErrorDetails#errorCode() 값이 인 경우 Amazon S3 API 참조의 오류 코드 목록을 사용하여 자세한 내용을 확인하세요.

SdkClientException

SdkClientException은 AWS로 요청을 전송하려 하거나 AWS의 응답을 파싱하려 하는 동안 Java 클라이언트 코드 내부에서 문제가 발생했음을 나타냅니다. SdkClientException은 일반적으로 SdkServiceException보다 더 심각하며, 클라이언트에서 AWS 서비스를 호출할 수 없게 하는 중요한 문제를 나타냅니다. 예를 들어 클라이언트 중 하나에서 작업을 호출하려 할 때 네트워크 연결을 사용할 수 없는 경우AWS SDK for Java는 SdkClientException을 발생합니다.

예외 및 재시도 동작

Java용 SDK는 몇 가지 클라이언트측 예외 및 AWS 서비스 응답에서 수신한 HTTP 상태 코드에 대한 요청을 재시도합니다. 이러한 오류는 서비스 클라이언트가 기본적으로 RetryMode 사용하는 레거시의 일부로 처리됩니다. 의 Java API 참조에서는 모드를 구성할 수 있는 다양한 방법을 RetryMode 설명합니다.

자동 재시도를 트리거하는 예외 및 HTTP 상태 코드를 사용자 정의하려면 RetryOnExceptionsCondition 및 RetryOnStatusCodeCondition 인스턴스를 추가하는 RetryPolicy와 함께 서비스 클라이언트를 구성하세요.