의 오류 처리 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.는 보다 일반적인 SdkServiceException의 하위 클래스AwsServiceException입니다. AwsServiceExceptions는의 오류 응답을 나타냅니다 AWS 서비스. 예를 들어 존재하지 않는 Amazon EC2 인스턴스를 종료하려고 하면 Amazon EC2 가 오류 응답을 반환하고 해당 오류 응답의 모든 세부 정보가 AwsServiceException 발생한에 포함됩니다.

가 발생하면 요청이 로 성공적으로 전송되었지만 성공적으로 처리할 수 AWS 서비스 없다는 것을 AwsServiceException알 수 있습니다. 이는 요청의 파라미터 오류 또는 서비스 측의 문제로 인해 발생할 수 있습니다.

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 또는 응답을 구문 분석하려고 시도하는 동안 Java 클라이언트 코드 내에서 문제가 발생했음을 나타냅니다 AWS. SdkClientException는 일반적으로 보다 심각SdkServiceException하며 클라이언트가 서비스를 호출하지 못하게 하는 주요 문제를 나타냅니다 AWS . 예를 들어 클라이언트 중 하나에서 작업을 호출하려고 할 때 네트워크 연결을 사용할 수 없는 SdkClientException 경우에서이 AWS SDK for Java 발생합니다.

예외 및 재시도 동작

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

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