기록일자

24.9.13 ~

문제 상황

• 앞서, AOP를 이용하여 동아리내 권한을 검증하는 로직을 분리하였다.

• 하지만, 해당 로직은 API가 호출시 RestController에 도달하기전 실행되는, @Before advice이기 때문에, Aspect에서 발생한 예외를 Controller에서 잡아 ResponseEntity에 HTTP에러 코드를 담아 보내주는 커스텀 로직에 도달하지 못했다.

  catch (Exception e) {
              return ResponseEntity.status(HttpStatus.CONFLICT).body(e.getMessage());
          }
  

  • 해당 로직을 수행하지 못함.

• 그래서, GlobalExceptionHandling으로 AOP에서 발생하는 예외도 잡아, 클라이언트에게 적절한 에러코드를 잡아주도록 구현하였다.

• 해당 문제 상황이 아니어도, Try Catch구문이 비즈니스 로직 속에 너무 많이 담기게 되었고, 이로 인해, 코드의 가독성이 떨어지고 한번에 관리하기 어려워지며, 비즈니스 로직에 예외를 처리하는 책임이 분리가 되지 않는다는 문제가 있었다.

• 이런 문제 때문에 스프링 MVC에서 제공하는 전역예외처리 기능을 사용하였고, 기본적으로 스프링 MVC의 예외처리 방식에 대한 깊은 이해가 필요할 것 같아 공부하였다.

구현과정

• Custom Exception 생성
  • 왜 RuntimeException를 상속받아 구현하였는가?
    • API 호출시, 대개 비즈니스 로직은 에러 발생시 별도의 처리로직을 작성하기보다, 클라이언트에게 잘못된 호출에 대한 에러 정보를 보내준다. 언체크드 예외는 메소드에서 throws로 선언할 필요가 없고, 호출한 코드에서 명시적으로 try-catch로 처리할 필요도 없다.
    • 즉, 언체크드 예외는 예외가 발생할 가능성이 있을 때, 굳이 강제적으로 예외처리를 하지 않아도 되는 상황에서 적절하다.
    • 예외처리에 대해 유연성을 지니고 있고, 앞서 말한 API 서버 특성상, 예외에 대한 별도의 비즈니스 로직이 필요없다.
    • 또한, 체크 에러로 구현 한다면 불필요한 throws가 전파된다.
    • 또한 Spring은 내부적으로 발생한 예외를 확인하여 언체크 예외이거나 에러라면 자동으로 롤백시키도록 처리한다. Spring에서 체크 예외만 롤백을 안하는 이유는 체크 예외는 처리가 강제되기 때문에 개발자가 무언가를 처리할 것이라는 기대 때문이다.
• @RestControllerAdvice를 이용하여, Handler 메소드 작성
  • /v1/common/exception/GlobalExceptionHandler.java
  • 해당 메소드들은, 클라이언트에게 전달할 예외 메시지를 ResponseEntity<Object> 에 담아 전달한다.
  • 해당 클래스에서는 ResponseEntity 에 담길 메시지의 공통된 양식을 지정하여, 응답메시지들이 공통된 양식으로 반환되어, 클라이언트와의 소통을 원활하게 하였다.

Spring 프레임워크에서 예외 발생 시 처리하는 흐름

• 일단 기본적으로, Spring MVC 프레임워크에서 예외를 처리하는 과정에 대한 이해를 해보자

  [SPRING] 스프링 예외처리 방법과 전략, @ControllerAdvice

• 예외는 크게 2가지가 발생한다.

  • Dispatcher Servlet 내에서 발생하는 예외
  • Filter 에서 발생하는 예외

1. Dispatcher Servlet 내에서 발생하는 예외

• 해당 예외는 대부분 Controller, Service, Repository 에서 발생하는 예외들이다.
• 스프링은 기본적으로 예외처리를 위한 BasicErrorController 가 있다고, 스프링 부트는 예외가 발생하면 기본적으로 /error 로 예외요청을 다시 전달하도록 WAS설정을 하였다.
• 그렇기 때문에, 예외처리를 별도로 해주지 않으면, 아래와 같이 Was에 도달한 뒤 BasicErrorController 를 실행하기 위해 컨트롤러를 2번 거치게 된다.

컨트롤러 수신 : WAS -> 필터 -> 디스패처 서블릿 -> 인터셉터 -> 컨트롤러

컨트롤러 송신 : 컨트롤러(예외발생) -> 인터셉터 -> 디스패처 서블릿 -> 필터 -> WAS -> 필터
-> 디스패처 서블릿 -> 인터셉터 -> 컨트롤러(BasicErrorController)
-> 인터셉터 -> 디스패처 서블릿 -> 필터 -> WAS