📌 Spring 예외 처리 실습 (@ExceptionHandler & @ControllerAdvice)

📅 날짜

2025-04-24

---

📝 학습 내용

1️⃣ @ExceptionHandler 개념

✅ 설명

• @ExceptionHandler는 스프링 MVC에서 특정 컨트롤러 내 예외를 처리하는 어노테이션.
• 발생할 수 있는 예외 타입을 지정해두고, 예외 발생 시 해당 메서드가 호출됨.
• 반환값으로 View 이름을 리턴하여 에러 페이지로 이동.

---

2️⃣ 컨트롤러 개별 예외 처리 예제

@ExceptionHandler(FileNotFoundException.class)
public String fileNotFoundExceptionHandler(Exception e, Model model) {
    log.error("error: " + e);  // 예외 로그 기록
    return "except/error";     // 에러 페이지로 포워딩
}

• 특정 예외 처리 시 주로 사용하는 방식.
• 컨트롤러마다 별도로 작성해야 하기 때문에 예외가 많아지면 관리가 번거로움.

---

3️⃣ 모든 예외 통합 처리 (컨트롤러 단위)

@ExceptionHandler(Exception.class)
public String exceptionHandler(Exception e, Model model) {
    log.error("error: " + e);
    return "except/error";
}

• 컨트롤러 내에서 발생하는 모든 예외를 하나의 메서드로 처리.
• 단, 이 방법도 컨트롤러별 반복 발생.

---

4️⃣ 전역 예외 처리 (@ControllerAdvice)

@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public String allExceptionHandler(Exception e, Model model) {
        log.info("GlobalExceptionHandler's error : " + e);
        model.addAttribute("ex", e);
        return "global_error";
    }
}

• 프로젝트 전체 예외를 한 곳에서 일괄 처리.
• 예외 처리 로직을 통합하고, 코드 중복을 줄일 수 있음.
• 실무에서는 주로 이 방식을 사용.

---

5️⃣ JSP 에러 페이지 예시

<%@ page isErrorPage="true" %>
<h1>ERROR PAGE</h1>
EXCEPTION : <%= exception %>   <!-- 예외 객체 출력 -->

• isErrorPage="true" 설정 시, JSP 내에서 exception 객체 사용 가능.
• 발생한 예외의 상세 정보를 사용자에게 표시하거나, 사용자 친화적으로 가공해 출력 가능.

---

🔥 정리

• 국소적 예외 처리: 컨트롤러마다 예외를 다르게 처리해야 할 때 유용.
• 전역 예외 처리: 시스템 전체의 예외를 일괄 관리하고 싶을 때 사용.
• 실무 팁:
  • 공통 예외는 @ControllerAdvice로 처리.
  • 특정 컨트롤러만의 로직적 예외는 @ExceptionHandler로 별도 처리.
• 반드시 로깅을 통해 예외 추적 가능하도록 설정할 것.

---

🔗 참고 자료

• Spring 공식 문서 - Exception Handling
• Lombok @Slf4j

---