직접 만드는 파이썬 예외

지난 글에서는 에러 메시지를 읽으며 문제가 생긴 위치와 원인을 찾아봤어요. 이번에는 한 발 더 나아가서, 문제가 생겼을 때 내가 직접 예외를 일으키는 방법을 알아보겠습니다. 파이썬에서는 raise를 쓰면 돼요. 이름만 보면 뭔가 크게 일을 벌이는 느낌인데, 사실은 “여기서는 더 진행하면 안 돼요!” 하고 알려 주는 장치입니다.

raise로 잘못된 상황 알리기

raise로 잘못된 상황을 알리는 흐름

예를 들어 나이를 입력받는 함수가 있다고 해볼게요. 나이는 음수가 될 수 없으니, 그런 값이 들어오면 그냥 계산을 이어 가기보다 이유를 알려 주는 편이 낫습니다.

def ticket_price(age):
    if age < 0:
        raise ValueError("나이는 0 이상이어야 합니다")

    return 0 if age < 8 else 10000

raise ValueError(...)가 실행되면 그 자리에서 함수가 멈추고 예외가 발생합니다. 메시지도 직접 넣을 수 있어서, 나중에 에러를 읽을 때 “왜 멈췄지?”를 파악하기 쉬워요.

여기서 ValueError는 값이 적절하지 않을 때 쓰는 파이썬의 기본 예외예요. 숫자를 기대했는데 문자가 들어왔다면 TypeError가 더 알맞을 수 있고요. 상황에 맞는 기본 예외가 이미 있다면 먼저 그걸 쓰는 게 간단합니다.

예외는 어디서 처리할까?

예외를 발생시키고 처리하는 순서

예외를 발생시키는 곳과 처리하는 곳은 꼭 같을 필요가 없습니다. 함수는 문제가 있다는 사실을 알리고, 함수를 호출한 쪽에서 안내 문구를 보여 주거나 다른 동작을 정할 수 있어요.

try:
    price = ticket_price(-3)
except ValueError as error:
    print(f"입력값을 확인해 주세요: {error}")

try 안에서 예외가 발생하면, 파이썬은 뒤에 있는 except 중 맞는 예외를 찾아 실행합니다. as error는 예외 객체를 변수에 담는 문법이라 메시지를 출력하거나 기록할 때 쓸 수 있어요.

다만 모든 코드를 try-except로 둘러싸면 문제가 가려질 수 있습니다. 이 함수처럼 입력값을 검사하는 쪽에서는 예외를 발생시키고, 사용자에게 어떻게 보여 줄지 결정하는 쪽에서 처리하면 역할이 깔끔해져요. 솔직히 말하면 저도 초반에는 일단 전부 잡고 보자는 마음으로 except를 넓게 썼다가, 진짜 고쳐야 할 오류까지 조용히 묻어 버린 적이 있답니다.

사용자 정의 예외가 필요한 순간

기본 예외와 사용자 정의 예외 비교

기본 예외로 충분한 상황도 많지만, 프로그램만의 규칙이나 상태를 표현해야 할 때는 직접 예외를 만들 수 있습니다. 예를 들어 예약 시스템에서 좌석이 이미 찼다는 사실을 ValueError만으로 표현하면, 호출하는 쪽에서 다른 값 오류와 구분하기가 어렵겠죠.

class SoldOutError(Exception):
    pass

def reserve(remaining):
    if remaining <= 0:
        raise SoldOutError("예약 가능한 좌석이 없습니다")

사용자 정의 예외는 보통 Exception을 상속해 만들어요. 이름 끝에 Error를 붙이면 예외라는 점도 드러나고, pass는 클래스에 추가 동작이 아직 없다는 뜻입니다. 짧지만 이 이름 덕분에 코드의 의도가 훨씬 잘 보입니다.

꼭 새 예외 클래스를 만들어야 하는 건 아니에요. 단순히 값이 잘못됐다는 뜻이면 ValueError로 충분할 수 있습니다. 반대로 프로그램을 쓰는 사람이 구분해서 처리해야 하는 상황이라면, 그 상황에 맞는 이름을 가진 예외가 유용해요.

예외 이름으로 처리도 나누기

예외 종류에 따라 처리 방법을 나누는 모습

직접 만든 예외는 except에서 이름으로 골라 처리할 수 있습니다. 좌석이 없을 때와 숫자를 잘못 전달했을 때를 다르게 안내하고 싶다면 이렇게 나눌 수 있어요.

try:
    reserve(0)
except SoldOutError as error:
    print(f"예약 실패: {error}")
except TypeError:
    print("좌석 수는 숫자로 입력해 주세요")

SoldOutError는 우리가 정한 예약 규칙을, TypeError는 자료형 문제를 나타냅니다. 예외 이름만 봐도 어느 쪽을 처리하는지 알 수 있으니, 코드가 길어져도 흐름을 따라가기 편해져요.

예외 클래스를 너무 잘게 나누면 오히려 읽기 어려워질 수 있습니다. 먼저 기본 예외로 표현해 보고, 호출하는 쪽에서 실제로 구분해야 할 때 사용자 정의 예외를 추가해도 늦지 않아요. 예외는 오류를 감추는 장치가 아니라, 문제가 무엇인지 전달하는 약속이라고 생각하면 됩니다.

다음은 파일 읽기와 쓰기

이번에는 raise로 직접 예외를 발생시키고, 사용자 정의 예외로 프로그램의 규칙을 표현해 봤습니다. 입력값 검사나 예약 가능 여부처럼 “이 조건에서는 진행할 수 없다”는 상황을 코드에 분명하게 남길 수 있죠.

다음 글에서는 파일을 읽고 쓰는 방법을 다룹니다. 파일이 없거나 권한이 부족한 경우에도 예외를 만날 수 있으니, 오늘 살펴본 예외 처리 흐름이 다시 등장할 거예요. 이제 텍스트 파일을 파이썬으로 열어 볼 차례입니다.

AIWD 소모임AI 자동화 오픈톡