시스템 안정성을 위해 에러 발생 시의 대응 체계를 구축하는 예외 처리 구조화 방법을 정리했다.
스프링(Spring) 환경에서 전역적으로 예외를 관리하는 기법을 분석했다.
@ControllerAdvice를 통한 전역 예외 관리
개별 컨트롤러의 try-catch 중복을 제거하기 위해 @ControllerAdvice를 활용한다.
애플리케이션 전체의 예외를 중앙에서 처리할 수 있다.
@ControllerAdvice
public class GlobalExceptionHandler {
// 1. 비즈니스 예외 처리 (데이터 부재 등)
@ExceptionHandler(DataNotFoundException.class)
public String handleNotFound(Exception e, Model model) {
model.addAttribute("errorMessage", "요청한 정보를 찾을 수 없다.");
return "error/404";
}
// 2. 공통 예외 처리
@ExceptionHandler(Exception.class)
public String handleAll(Exception e, Model model) {
model.addAttribute("errorMessage", "시스템 오류가 발생했다.");
return "error/500";
}
}
예외 처리 구조화의 필요성
- 관심사 분리: 컨트롤러 코드가 예외 처리 로직과 분리되어 가독성이 향상된다.
- 일관된 응답: 에러 발생 시 사용자에게 일관된 에러 페이지를 제공한다.
- 유지보수 효율: 에러 처리 정책 변경 시 중앙 관리 클래스만 수정하면 된다.
설계의 세심함
효과적인 에러 메시지는 사용자에게는 안내를 제공하고 개발자에게는 원인 파악의 단서를 제공해야 한다.
사용자용 안내 페이지와 내부 로깅 시스템을 분리 설계하는 것은 고품질 소프트웨어 개발의 필수 요소이다.
체계적인 예외 설계가 시스템의 완성도를 높인는 것 같다.
