[Java] 사용자 정의 예외(Custom Exception) 만들기

Java에서는 기본 제공 예외(Exception) 외에도 개발자가 직접 새로운 예외 클래스를 정의할 수 있습니다.
이를 사용자 정의 예외(Custom Exception)라고 하며, 비즈니스 로직에서 의미 있는 예외를 명확하게 표현할 때 매우 유용합니다.

Custom Exception은 기존 예외로 상황을 설명하기 어렵거나,
코드 가독성과 유지보수성을 높이고 싶을 때 사용됩니다.

 

1. 사용자 정의 예외를 만드는 기본 원칙

사용자 정의 예외 클래스는 반드시 Exception 또는 RuntimeException을 상속해야 합니다.

✔ Checked Exception 만들기

→ Exception 상속

✔ Unchecked Exception 만들기

→ RuntimeException 상속

 

2. Checked Custom Exception 예제

Checked Exception은 try-catch 또는 throws가 필수입니다.

class InvalidAgeException extends Exception {
    public InvalidAgeException(String message) {
        super(message);
    }
}

사용:

public void checkAge(int age) throws InvalidAgeException {
    if (age < 0) {
        throw new InvalidAgeException("나이는 음수일 수 없습니다.");
    }
}

설명

• 컴파일 단계에서 반드시 예외 처리가 필요
• 예외 발생이 코드 흐름의 정상적인 일부라고 보기 어려운 경우 사용

 

3. Unchecked Custom Exception 예제

RuntimeException을 상속하면 RuntimeException 계열의 예외가 됩니다.
throws 선언 없이 자유롭게 사용할 수 있습니다.

class InvalidScoreException extends RuntimeException {
    public InvalidScoreException(String message) {
        super(message);
    }
}

사용:

public void checkScore(int score) {
    if (score < 0 || score > 100) {
        throw new InvalidScoreException("점수는 0~100 사이여야 합니다.");
    }
}

설명

• 필요할 때 바로 throw 가능
• 호출하는 쪽에서 처리하지 않아도 컴파일 오류 없음

 

4. Custom Exception에 다양한 생성자 추가하기

에러 메시지 + 원인 예외(cause)까지 전달하고 싶다면 여러 생성자를 제공할 수 있습니다.

class FileProcessException extends Exception {
    public FileProcessException() { }

    public FileProcessException(String message) {
        super(message);
    }

    public FileProcessException(String message, Throwable cause) {
        super(message, cause);
    }
}

사용:

try {
    // 파일 처리 로직
} catch (IOException e) {
    throw new FileProcessException("파일 처리 실패", e);
}

 

5. Custom Exception로 비즈니스 의미 표현하기

예: 은행 계좌에서 잔액 부족일 때 명확한 예외를 만들 수 있음

class NotEnoughBalanceException extends RuntimeException {
    public NotEnoughBalanceException(String message) {
        super(message);
    }
}

사용:

public void withdraw(int amount) {
    if (amount > balance) {
        throw new NotEnoughBalanceException("잔액이 부족합니다.");
    }
}

이렇게 하면 예외 메시지만 보고도 어떤 비즈니스 문제인지 명확히 이해할 수 있습니다.

 

6. Custom Exception을 사용할 때의 장점

✔ 비즈니스 로직을 더 명확하게 표현

기존 예외보다 더 구체적인 의미를 가질 수 있음

✔ 유지보수와 디버깅 용이

어떤 상황에서 문제가 발생했는지 명확하게 파악 가능

✔ 예외 계층(Custom Hierarchy) 설계 가능

유사한 예외를 한꺼번에 처리하거나 구분하여 처리할 수 있음

예:

BankException
 ├─ NotEnoughBalanceException
 ├─ InvalidAccountException
 └─ TransferLimitException

 

7. 전체 예제

class AgeException extends Exception {
    public AgeException(String message) {
        super(message);
    }
}

class Person {
    private int age;

    public void setAge(int age) throws AgeException {
        if (age < 0) {
            throw new AgeException("나이는 음수일 수 없습니다.");
        }
        this.age = age;
    }
}

사용:

public static void main(String[] args) {
    Person p = new Person();

    try {
        p.setAge(-1);
    } catch (AgeException e) {
        System.out.println(e.getMessage());
    }
}

출력:

나이는 음수일 수 없습니다.

 

8. 정리

• Custom Exception은 Exception 또는 RuntimeException을 상속해 만들 수 있음
• Checked Exception → 반드시 처리 필요
• Unchecked Exception → 자유롭게 throw 가능
• 의미 있는 예외를 만들어 가독성과 유지보수성을 향상시킴
• 비즈니스 로직을 더 정확하게 표현할 수 있음