[JAVA] 코드에 생명력을 불어넣는 기술, 사용자 정의 예외(Custom Exception) 설계법

Custom Exception

 

 

자바 프로그래밍을 하다 보면 RuntimeException, IllegalArgumentException 같은 표준 예외만으로는 현재 발생한 비즈니스적 오류 상황을 설명하기에 부족함을 느낄 때가 많습니다. 단순히 "인자가 잘못되었다"는 정보보다 "잔액이 부족하여 결제에 실패했다"거나 "허가되지 않은 지역에서의 접근이다"라는 구체적인 정보가 코드 자체에 녹아있어야 유지보수가 수월해집니다.

오늘은 프로그램의 가독성을 높이고 예외 처리 전략을 고도화할 수 있는 사용자 정의 예외(Custom Exception)를 만드는 방법과 실무적인 설계 원칙을 심도 있게 다뤄보겠습니다.

1. 사용자 정의 예외가 왜 필요한가?

표준 예외를 사용하는 것도 좋지만, 커스텀 예외를 만들면 다음과 같은 특별한 장점이 있습니다.

• 이름 자체로 정보를 전달: 예외 클래스의 이름만으로도 어떤 비즈니스 로직에서 문제가 생겼는지 즉시 파악할 수 있습니다.
• 상세한 문맥(Context) 제공: 예외 발생 당시의 주문 번호, 사용자 ID 등 디버깅에 필요한 추가 데이터를 예외 객체 내부에 저장할 수 있습니다.
• 일관된 예외 처리: 특정 도메인(예: 결제, 회원가입)에서 발생하는 예외들만 따로 묶어서 처리하는 통합 예외 핸들러를 구성하기 용이합니다.

2. 사용자 정의 예외를 만드는 2가지 핵심 경로

자바에서는 예외의 성격에 따라 Exception 또는 RuntimeException 중 하나를 선택하여 상속받아야 합니다.

선택 기준	Checked Custom Exception	Unchecked Custom Exception
상속 클래스	java.lang.Exception	java.lang.RuntimeException
처리 강제성	호출자에게 예외 처리를 강제함 (try-catch)	명시적인 처리를 강제하지 않음
주요 용도	외부 시스템 연동 등 복구가 필요한 상황	비즈니스 로직 위반 (실무 권장)

최근 모던 자바 개발 트렌드(Spring Framework 등)에서는 코드의 결합도를 낮추기 위해 대부분 Unchecked Exception(RuntimeException 상속) 방식을 선호합니다.

3. Sample Example: 실무형 커스텀 예외 구현

잔액 부족 상황을 알리는 예외를 직접 만들어 보겠습니다. 단순히 메시지만 전달하는 것이 아니라, 부족한 금액 정보를 포함시켜 가치를 더했습니다.

Step 1: 예외 클래스 정의

/**
 * 잔액 부족 시 발생하는 비즈니스 예외
 */
public class InsufficientBalanceException extends RuntimeException {
    private final long missingAmount; // 부족한 금액 정보 추가

    public InsufficientBalanceException(long currentBalance, long requestedAmount) {
        super(String.format("잔액이 부족합니다. 현재: %d, 요청: %d", currentBalance, requestedAmount));
        this.missingAmount = requestedAmount - currentBalance;
    }

    public long getMissingAmount() {
        return missingAmount;
    }
}

Step 2: 예외 발생 및 활용

public class BankService {
    public void withdraw(long balance, long amount) {
        if (balance < amount) {
            // 커스텀 예외를 능동적으로 발생시킴
            throw new InsufficientBalanceException(balance, amount);
        }
        System.out.println("출금 성공!");
    }
}

4. 전문가를 위한 예외 설계 규칙 (Best Practices)

1. 의미 있는 이름 짓기: 항상 Exception으로 끝나는 이름을 사용하세요. 이름만 보고도 상황이 짐작되어야 합니다.
2. 표준 생성자 제공: Throwable의 기본 생성자들을 최대한 오버라이딩하여 스택 트레이스가 유실되지 않도록 하세요.
3. 메시지에 핵심 데이터 포함: 예외 메시지는 로그에 남는 유일한 단서입니다. 어떤 값 때문에 예외가 터졌는지 구체적으로 기록하세요.
4. 예외 체이닝(Chaining): 만약 다른 예외 때문에 커스텀 예외가 발생했다면, 원인 예외(Cause)를 생성자에 넘겨 추적성을 유지하세요.

5. 결론: 예외는 소통의 도구입니다

사용자 정의 예외는 단순히 에러를 처리하는 문법이 아니라, 개발자와 개발자, 혹은 개발자와 시스템 사이의 소통 도구입니다. 잘 설계된 커스텀 예외는 코드의 의도를 명확하게 드러내고, 장애 발생 시 원인 파악 시간을 획기적으로 단축해 줍니다. 여러분의 프로젝트 도메인에 맞는 예리한 예외 클래스들을 설계하여 코드의 완성도를 한 단계 끌어올려 보시기 바랍니다.

---

참고 문헌 및 출처

• Oracle Java Documentation: Creating Your Own Exception Classes
• Joshua Bloch, "Effective Java 3rd Edition", Item 72: Favor the use of standard exceptions (but know when to custom).
• Clean Code by Robert C. Martin - Chapter 7: Error Handling.