커스텀 예외 클래스만 수십 개 만들고 있는 개발자에게
by 그릿 | GROWTH_ESSAY | 2026-11-19
#예외처리 #백엔드 #성장"비즈니스 예외를 명확히 구분해야 하니까, 엔티티마다 예외 클래스를 따로 만들었습니다."
멘토링에서 주니어 개발자들의 코드를 열어보면 흔히 마주치는 패키지가 있습니다. 바로 exception 패키지입니다. UserNotFoundException, OrderNotFoundException, ItemNotFoundException처럼 엔티티 이름만 바뀐 채 서른 개, 마흔 개씩 수북하게 쌓여 있는 빈 클래스 파일들입니다.
열어보면 속 내용도 판박이입니다. RuntimeException을 상속받고 super(message)만 호출하는 두 줄이 전부입니다. 예외 클래스는 40개인데, 정작 전역 컨트롤러 어드바이스를 열어보면 그 40개를 하나의 핸들러에서 묶어 400 에러 하나로 퉁쳐서 내보내고 있습니다.
예외를 단순한 이름표로 쓰는 착각
많은 주니어 개발자가 예외를 '오류 상황을 설명하는 이름표'로 취급합니다. 오류 상황이 생길 때마다 새 클래스 파일을 추가합니다. 파일이 수십 개 쌓여갈수록 예외 처리를 꼼꼼하고 객체지향적으로 하고 있다는 착각에 빠집니다.
200명이 넘는 개발자들의 코드를 보면서 확인한 사실이 있습니다. 클래스가 40개든 100개든, 처리 방식이 똑같다면 그 클래스들은 아무런 책임을 지지 않는 빈 껍데기입니다. 호출하는 쪽에서 그 예외를 구별해 다른 방식으로 복구하거나 다른 분기를 타지 않는다면 새 클래스를 만들 이유가 없습니다. 시스템 복잡도만 올리고 코드를 읽는 동료에게 불필요한 탐색 비용을 떠넘길 뿐입니다.
예외의 가치는 복구 가능성에서 나옵니다
예외 클래스를 새로 만들어야 하는 유일한 기준은 하나입니다. '이 예외를 만났을 때 호출자가 다른 행동을 할 수 있는가'입니다. 상위 계층에서 이 예외를 잡아서 다른 데이터 소스를 조회해야 하는가, 서킷 브레이커를 열어야 하는가, 아니면 트랜잭션을 롤백하고 클라이언트에게 정해진 에러 응답을 내려주고 끝내야 하는가에 대한 판단입니다.
클라이언트에게 에러 코드와 안내 문구를 내려주는 게 목적이라면, 공통 비즈니스 예외 하나에 에러 코드 Enum을 주입하는 것만으로 충분합니다. 40개의 클래스 파일을 복사해 붙여넣을 시간에, 프론트엔드가 화면을 분기할 수 있는 일관된 에러 코드 체계를 설계하는 편이 훨씬 실용적입니다.
누가 이 예외를 처리할 것인가
새 예외 클래스를 만들기 전에 질문해야 합니다. 내가 지금 던지는 예외를 상위 계층에서 잡아서 정상 흐름으로 복구할 수 있는가. 복구할 수 없다면 전역 핸들러에서 규격화된 에러 응답으로 변환할 표준 정책은 있는가. 이 두 질문에 답하지 못하는 예외는 프로그램을 중단시키는 폭탄 돌리기에 불과합니다.
클래스 파일의 개수로 성실함을 증명하려 하지 마십시오. 예외 처리의 완성도는 클래스 숫자가 아니라, 장애가 터졌을 때 시스템이 얼마나 예측 가능하게 반응하고 복구되는가에서 결정됩니다. 호출자가 구별하지도 않는 빈 껍데기 클래스가 쌓여 있다면, 과감하게 정돈하고 처리 기준부터 다시 세우십시오.