예외 처리 (Exception Handling)

🔍 개요

• Spring MVC는 전역 예외 처리와 컨트롤러 단위 예외 처리를 지원한다.
• 애플리케이션에서 발생한 예외를 중앙집중적으로 관리해 유지보수성을 높인다.
• Checked/Unchecked 예외의 차이를 이해하면 적절한 예외 설계를 할 수 있다.

---

☝🏻 한줄 요약

Spring MVC 예외 처리는 @ControllerAdvice + @ExceptionHandler 조합으로 전역/로컬 처리 가능하며, 대부분의 Spring 예외는 UncheckedException(RuntimeException) 기반이다.

---

🤔 왜 필요한가?

• 컨트롤러마다 예외 처리 로직을 중복 작성하는 비효율 제거
• 공통된 예외 응답 형식을 유지
• 오류 페이지/JSON 응답 등 다양한 포맷 지원
• 예외 원인을 로깅하고, 클라이언트에는 필요한 정보만 노출

---

⚙️ 주요 구성 요소

@ControllerAdvice

• 전역 예외 처리 클래스에 선언
• 모든 컨트롤러에 공통 적용 가능

@ExceptionHandler

• 특정 예외 타입을 처리하는 메서드 정의
• 메서드 파라미터로 예외 객체, 요청/응답, 모델 등을 받을 수 있음
• 리턴 타입은 View 이름, 데이터 객체, ResponseEntity 등 다양

CheckedException

• Exception 상속, RuntimeException 비포함
• 반드시 처리(try-catch 또는 throws)해야 함
• 컴파일 시 강제
• ex) IOException, SQLException

UncheckedException

• RuntimeException 상속
• 처리 강제 없음 (컴파일 에러 X)
• 호출 계층에서 적절한 위치에서 처리 필요
• Spring 예외 대부분이 해당

---

🔧 예시

(A) 전역 예외 처리

@ControllerAdvice
public class GlobalExceptionHandler {
 
    @ExceptionHandler(UserNotFoundException.class)
    public String handleUserNotFound(UserNotFoundException ex, Model model) {
        model.addAttribute("exception", ex);
        return "error";
    }
}

(B) 컨트롤러 단위 예외 처리

@Controller
public class UserController {
 
    @GetMapping("/users/{id}")
    public String getUser(@PathVariable Long id) {
        throw new UserNotFoundException();
    }
 
    @ExceptionHandler(UserNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public void notFound() {
        // No content
    }
}

(C) JSON 응답 예외 처리

@ControllerAdvice
public class ApiExceptionHandler {
 
    @ExceptionHandler(Exception.class)
    @ResponseBody
    public ErrorDto handleException(Exception ex) {
        return new ErrorDto("ERR001", ex.getMessage());
    }
}

---

⚠️ 주의할 점

• @ControllerAdvice는 @RestControllerAdvice로 대체 가능 (모든 응답에 자동 @ResponseBody)
• 예외 처리 시 민감한 서버 내부 정보를 클라이언트에 노출하지 말 것
• CheckedException은 의도적인 예외 흐름 제어가 필요한 경우에만 사용
• HTTP 상태 코드 명시 (@ResponseStatus 또는 ResponseEntity)

---

🔗 관련

• Spring MVC 개요
• Validation