파이썬 try-except 예외 처리 완벽 가이드: 사용자 정의 예외와 자원 안전 해제

파이썬의 try-except는 오류를 숨기는 문법이 아니라, 예상 가능한 실패만 구분해 처리하고 예상하지 못한 오류는 다시 드러내는 장치입니다. 실무에서는 구체적인 예외부터 잡고, 정상 흐름은 else에 두며, 파일·연결 같은 자원은 with 또는 finally로 반드시 정리하는 방식이 안전합니다.

파이썬 공식 예외 처리 문서 확인하기

try-except 실행 흐름부터 이해하세요

try에서 예외가 발생하면 남은 문장은 건너뛰고, 형식이 일치하는 첫 번째 except로 이동합니다. 처리기가 없으면 예외는 바깥 호출자에게 전달됩니다.

def parse_age(value):
    try:
        age = int(value)
    except (TypeError, ValueError) as exc:
        print(f"나이 변환 실패: {exc}")
        return None
    else:
        return age

print(parse_age("52"))

위 코드는 정수 변환 과정에서 예상되는 TypeError와 ValueError만 처리합니다. SyntaxError는 먼저 코드를 수정해야 합니다.

구체적인 예외부터 잡아야 하는 이유

모든 오류를 한꺼번에 잡으면 개발자가 즉시 알아야 할 문제까지 정상 처리된 것처럼 보일 수 있습니다. 복구 방법이 같은 예외만 튜플로 묶으세요.

상위 클래스인 Exception을 마지막에 잡아 기록해야 한다면, 로그를 남긴 뒤 raise로 다시 올리는 방법을 고려하세요. SystemExit와 KeyboardInterrupt까지 포함하는 BaseException은 일반 업무 코드에서 잡지 않는 것이 원칙입니다.

else와 finally는 역할이 다릅니다

else는 예외가 없을 때만 실행됩니다. 후속 코드를 이곳으로 빼면 너무 넓은 범위의 예외를 잡는 일을 줄일 수 있습니다. finally는 성공·실패와 관계없이 실행됩니다.

connection = None
try:
    connection = connect_database()
except ConnectionError as exc:
    print(f"연결 실패: {exc}")
else:
    save_report(connection)
finally:
    if connection is not None:
        connection.close()

finally 안의 return은 원래 반환값이나 예외를 가릴 수 있으므로 피하세요.

사용자 정의 예외로 업무 규칙을 표현하세요

잔액 부족이나 허용되지 않은 상태 변경 같은 업무 규칙 위반은 전용 예외 클래스로 표현할 수 있습니다. 이름은 Error로 끝내고 Exception을 상속합니다.

class InsufficientBalanceError(Exception):
    """출금액이 사용 가능한 잔액보다 클 때 발생"""

def withdraw(balance, amount):
    if amount <= 0:
        raise ValueError("출금액은 0보다 커야 합니다")
    if amount > balance:
        raise InsufficientBalanceError(
            f"잔액 {balance:,}원, 요청 {amount:,}원"
        )
    return balance - amount

하위 예외를 의미 있는 오류로 바꿀 때는 raise 새예외(...) from exc를 사용하세요. 원래 원인이 traceback에 연결됩니다.

파일과 연결은 with 문으로 안전하게 해제하세요

파일을 직접 열면 예외 발생 시 close()까지 도달하지 못할 수 있습니다. 컨텍스트 관리자를 지원한다면 with로 자동 정리하세요.

from pathlib import Path

path = Path("settings.txt")
try:
    with path.open("r", encoding="utf-8") as file:
        settings = file.read()
except FileNotFoundError:
    settings = ""
except PermissionError as exc:
    raise RuntimeError("설정 파일을 읽을 권한이 없습니다") from exc

네트워크 요청에서는 타임아웃, 연결 실패, HTTP 상태 오류를 구분하고 반복 실패를 로그로 남기세요.

예외 처리 실수 방지 체크리스트

• 복구할 수 있는 예상 예외만 잡았는지 확인합니다.
• 하위 예외 클래스를 상위 클래스보다 먼저 배치합니다.
• 빈 except와 이유 없는 pass를 사용하지 않습니다.
• 오류 메시지에 비밀번호, 토큰, 개인정보를 넣지 않습니다.
• 정상 후속 처리는 else, 필수 정리는 finally 또는 with에 둡니다.
• 기록 후 상위 호출자가 판단해야 하는 오류는 다시 raise합니다.
• 테스트에서 정상·예상 실패·예상 밖 실패 경로를 각각 확인합니다.

공식 출처

• Python 공식 튜토리얼: Errors and Exceptions
• Python 언어 참조: try 문
• Python 표준 라이브러리: contextlib

공식 문서 확인일: 2026년 8월 30일