[스프링] 스프링에서 예외 처리

June·2021년 8월 11일

[인턴] 엔테크 서비스

목록 보기

10/18

스프링에서 예외 발생위치

예외 처리 과정

WAS(여기까지 전파) <- 필터 <- 서블릿 <- 인터셉터 <- 컨트롤러(예외발생)

스프링의 처리과정을 보면 예외가 발생하는 부분은 크게 두가지로 나눌 수 있다.

Dispatcher Servlet내에서 발생하는 예외 (Controller, Service, Repository등등)
Dispatcher Servlet전의 서블릿 (Filter)에서 발생하는 예외

DispatcherServlet 예외

스프링 MVC에서 에러의 대다수는 DispatcherServlet에서 발생한다. HandlerExceptionResolver를 사용하면 예외를 내부 (Servlet Container 내부)에서 자체적으로 해결할 수 있다.

https://jaehun2841.github.io/2018/08/30/2018-08-25-spring-mvc-handle-exception/#%EB%93%A4%EC%96%B4%EA%B0%80%EB%A9%B0

Web Application 레벨 예외

클라이언트의 요청을 DispatcherServlet 밖에서 처리하는 도중 예외가 발생하면 DispatcherServlet이 예외를 처리해줄 수 없다. 즉, HandlerExceptionResolver의 처리를 받을 수 없다.

처리 못하는 이유는 DispatcherServlet에서 처리하기도 전에 예외가 발생되기 때문이다.

이렇게 Filter에서 예외가 발생하면 Web Application 레벨에서 처리를 해줘야 한다.

Filter에서 예외가 발생한다면?

web.xml에 error-page를 잘 등록해줘서 에러를 사용자에게 응답
Filter내부에서 예외를 처리하기 위한 필터를 따로 둬서 try-catch문을 사용하여 예외 처리
- 실제 시큐리티 인가 처리중 예외가 발생하면 ExceptionTranslationFilter에게 예외를 던져 처리한다. (try-catch)
Filter 내부에서 try-catch 구문을 통해 예외 발생 시, HandlerExceptionResolver를 빈으로 주입받아 @ExceptionHandler에서 처리하는 방법
- 즉, 필터에서 발생하는 예외를 DispatcherServlet의 예외 처리기인 HandlerExceptionResolver에 보내서 처리하는 방식이다.

예외 처리 방법

1. @ExceptionHandler

@ExceptionHandler애노테이션을 통해 Controller의 메서드에서 throw된 Exception에 대한 공통적인 처리를 할 수 있다.

@RestController
public class TestController {

    private final Logger logger = LoggerFactory.getLogger(UserController.class);

    // 예외 핸들러
    @ExceptionHandler(value = TestException.class)
    public String controllerExceptionHandler(Exception e) {
        logger.error(e.getMessage());
        return "/error/404";
    }

    @GetMapping("hello1")
    public String hello1() {
        throw new TestException("hello1 에러 "); // 강제로 예외 발생
    }

    @GetMapping("hello2")
    public String hello2() {
        throw new TestException("hello2 에러 "); // 강제로 예외 발생
    }
}

TestController내에서 발생하는 TestException에 대해서 예외가 발생하면 controllerExceptionHandler메서드에서 모두 처리해준다.

Controller 메서드 내의 하위 서비스 (Service, Repository등등)에서 예외가 발생하더라도, 중간에 처리하지 않는 이상 Controller단까지 예외가 던져지게 되고 @ExceptionHandler가 예외를 처리하게 된다.
Checked Exception, Runtime Exception 상관 없이 Controller까지 예외를 throw하면 처리가 가능하다.

2. @ControllerAdvice, @RestControllerAdvice

@ControllerAdvice
- 모든 Controller에서 발생하는 예외를 처리할 수 있게 해주는 애노테이션
- DispatcherServlet에서 발생하는 예외를 전역적으로 처리해준다.
@RestControllerAdvice
- @ControllerAdvice + @ResponseBody

@ControllerAdvice는 DispatcherServlet에서 발생하는 예외만 처리할 수 있다.

@RestControllerAdvice
public class GlobalExceptionHandler {

    private final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(value = TestException.class)
    public String testExceptionHandler(Exception e) {
        logger.error(e.getMessage());
        return "/error/404";
    }
}

Controller에서 발생하는 예외를 전역적으로 처리해준다.

Controller의 @ExceptionHandler와 ControllerAdvice의 @ExceptionHandler중 높은 우선순위는?

Controller의 @ExceptionHandler가 먼저다. 항상 스프링에서는 자세할 수록 높은 우선 순위를 가진다.

3. try-catch

@GetMapping("/api/v1/members")
public ResponseEntity getAllMember(Pageable pageable) {

    Page<Member> memberPage;
    
    // 반복적으로 발생하는 Try-Catch
    try {
          memberPage = memberFindService.getAllMemberPage(pageable);
    } catch (RuntimeException re) {
        return ResponseEntity.badRequest().build();
    } catch (Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
    }

    return ResponseEntity.ok().body(MemberAdminDto.Info.of(memberPage));
}