인프런 커뮤니티 질문&답변

blackjack_96님의 프로필 이미지

작성한 질문수

스프링 MVC 2편 - 백엔드 웹 개발 활용 기술

스프링 부트 - 오류 페이지1

특정 리소스가 없을때에 예외페이지 처리 방법 질문드립니다

작성

·

168

·

수정됨

0

[질문 템플릿]
1. 강의 내용과 관련된 질문인가요? (/아니오)
2. 인프런의 질문 게시판과 자주 하는 질문에 없는 내용인가요? (/아니오)
3. 질문 잘하기 메뉴얼을 읽어보셨나요? (/아니오)

[질문 내용]
예를 들어서, 게시글을 조회하는 서비스가 있다고 가정해 보겠습니다.

/post/158

위 URL을 요청할 경우, 웹 애플리케이션에서 id = 158인 게시글을 찾아 해당 내용을 클라이언트에게 주며, 만약 전달된 아이디에 해당하는 게시글이 없을 경우 예외(NoSuchPostException)을 반환하도록 구현을 했습니다.

그런데 이 때, 아무런 설정이 없으면 예외가 WAS까지 전달이 되면 무조건 500 Error가 발생이 되는 것으로 알고 있습니다.

제가 궁금한 것은

  1. 위와 같은 상황에서 404 에러가 아닌, 500에러를 반환하도록 구현하는 것이 맞는 지 궁금합니다. 158이라는 아이디에 해당하는 리소스가 없을 경우에는 Not Found 404 상태코드를 반환하는게 맞다고 생각을 하였는데, 실무에서는 이런 상황에서 어떠한 상태코드를 사용하는 지 궁금합니다.

  2. 특정 예외(이를테면 NoSuchPostException)상황에서는 404코드를 반환하도록 하고 싶은데, 이럴 경우 스프링에서 제공하는 BasicErrorController를 사용하지 못하고, 직접 에러 컨트롤러를 만들어서 처리해야 하나요? (스프링 인터셉터와 필터를 이용한 방법 모두 해보았는데 도저히 안되겠어서 질문드립니다)

답변 1

2

김영한님의 프로필 이미지
김영한
지식공유자

안녕하세요. blackjack_96님

웹 애플리케이션에서 리소스가 없는 경우에 적절한 HTTP 상태 코드를 반환하는 것은 중요합니다.

404 에러와 500 에러의 사용 상황

  • 404 에러(NotFound)는 요청된 자원이 서버에 존재하지 않을 때 사용하는 것이 일반적입니다. 예를 들어, 사용자가 /post/158 URL을 요청했을 때 id=158인 게시글이 데이터베이스에서 찾을 수 없으면 404 에러를 반환하는 것이 적절합니다.

  • 500 에러(InternalServerError)는 서버에서 처리할 수 없는 에러가 발생했을 때 사용합니다. 이는 대체로 프로그래밍 오류나 서버 내부의 문제로 발생하는 경우에 해당합니다.

여러분의 경우, id에 해당하는 게시글이 없을 때 404 에러를 반환하는 것이 맞습니다. 이는 사용자가 요청한 리소스가 서버에 존재하지 않음을 명확히 알려주기 때문입니다.

모든 개발자를 위한 HTTP 웹 기본 지식 강의를 복습해주세요 🙂

 

Spring에서 404 상태 코드를 반환하는 방법

  • Spring Framework에서는 예외 처리를 위해 @ExceptionHandler 어노테이션을 사용할 수 있습니다. 이를 사용하여 특정 예외에 대해 특정 HTTP 상태 코드를 반환하도록 설정할 수 있습니다.

  • 예를 들어, NoSuchPostException이 발생했을 때 404 상태 코드를 반환하도록 컨트롤러 내에서 다음과 같이 처리할 수 있습니다:

    @ControllerAdvice
    public class GlobalExceptionHandler {
        @ExceptionHandler(NoSuchPostException.class)
        public ResponseEntity<String> handleNoSuchPostException(NoSuchPostException ex) {
            return ResponseEntity.status(HttpStatus.NOT_FOUND).body("The requested post does not exist.");
        }
    }
    
  • @ControllerAdvice는 전역 예외 처리기로, 애플리케이션의 모든 컨트롤러에서 발생할 수 있는 예외를 처리할 수 있게 합니다. @ExceptionHandler는 특정 예외를 처리합니다.

Spring에서는 BasicErrorController를 확장하거나 대체하여 사용자 정의 에러 처리 방법을 구현할 수도 있습니다. 그러나 특정 예외 타입에 대해 직접 핸들러를 작성하는 것이 더 직관적이고 간단할 수 있습니다. 위와 같이 @ControllerAdvice@ExceptionHandler를 사용하는 방법이 일반적으로 권장되는 방식입니다.

감사합니다.

blackjack_96님의 프로필 이미지
blackjack_96
질문자

일요일에도 답변 달아주셔서 감사드립니다! 너무 명확하네요..