PYTHON 오류 처리 및 디버깅 Try, Except, Finally 블록: 예외 처리, 로깅, 그리고 방어적 프로그래밍 기법

5월 21, 2026

PYTHON 오류 처리 및 디버깅 Try, Except, Finally 블록: 예외 처리, 로깅, 그리고 방어적 프로그래밍 기법

소프트웨어 개발에서는 예기치 않은 오류가 발생할 수 있으며, 이러한 오류를 효과적으로 처리하고 디버깅하는 능력은 안정적이고 유지보수가 용이한 코드를 작성하는 데 필수적입니다. 본 포스팅에서는 파이썬에서 제공하는 Try, Except, Finally 블록을 비롯한 다양한 예외 처리 기법과, 사용자 정의 예외 클래스, 로깅, 그리고 디버깅 도구와 방어적 프로그래밍 기법을 심도 있게 다루어 보겠습니다. 이를 통해 독자 여러분께 실제 프로젝트에서 오류를 최소화하고, 문제 발생 시 신속하게 대응할 수 있는 전략을 제시하고자 합니다.

PYTHON 오류 처리의 중요성 및 기본 개념

어떠한 프로그램도 완벽하게 오류 없이 동작하기는 어렵습니다. 사용자의 잘못된 입력, 외부 시스템과의 통신 실패, 파일 입출력 문제 등 다양한 원인으로 오류가 발생할 수 있습니다. 이러한 오류를 적절하게 처리하지 않으면, 프로그램이 예기치 않게 종료되거나 데이터 손실 등의 치명적인 문제가 발생할 수 있습니다. 따라서, 예외 처리와 로깅, 그리고 방어적 프로그래밍 기법을 통해 오류를 사전에 방지하고, 발생한 오류를 효과적으로 관리하는 것이 중요합니다.

예외(Exception)와 오류(Error)의 구분

파이썬에서 예외(Exception)는 프로그램 실행 중 발생하는 비정상적인 상황을 나타내며, 오류(Error)는 주로 프로그래밍 실수나 논리적 문제로 인한 것이라고 볼 수 있습니다. 예외 처리 기법을 통해 예상 가능한 예외 상황에 대비함으로써, 프로그램이 중단되지 않고 안정적으로 동작하도록 할 수 있습니다.

예외 처리 기법: Try, Except, Finally 블록

파이썬에서는 try, except, finally 블록을 이용하여 예외 처리를 수행합니다.

[##_Image|kage@bhq2PX/btsMENNhJUR/AAAAAAAAAAAAAAAAAAAAADrbj9QSG8hMFt2ns6bPTWqOljwt68ZWYIs-Bj__OyhI/img.png?credential=yqXZFxpELC7KVnFOS48ylbz2pIh7yKj8&expires=1780239599&allow_ip=&allow_referer=&signature=UtN8jSDRVfrmliVtsRtATnig1wI%3D|CDM|1.3|{"originWidth":550,"originHeight":349,"style":"widthContent"}_##]

try: 예외가 발생할 가능성이 있는 코드를 실행합니다.
except: try 블록 내에서 예외가 발생했을 때, 해당 예외를 잡아내어 처리하는 역할을 합니다.
finally: 예외 발생 여부와 상관없이 반드시 실행되어야 하는 코드를 포함합니다.

다음은 기본적인 예외 처리 예제입니다.

try:
    # 예외가 발생할 가능성이 있는 코드
    num = int(input("숫자를 입력하세요: "))
    result = 100 / num
except ZeroDivisionError as e:
    print("0으로 나눌 수 없습니다:", e)
except ValueError as e:
    print("유효한 숫자를 입력하세요:", e)
else:
    print("계산 결과:", result)
finally:
    print("프로그램 종료 전 반드시 실행됩니다.")

위 예제는 사용자가 0을 입력하거나 숫자가 아닌 값을 입력할 경우에 각각 다른 예외를 처리하며, else 블록을 통해 예외가 발생하지 않은 경우에만 결과를 출력하고, finally 블록은 오류 발생 여부와 관계없이 항상 실행됩니다.

여러 예외 처리 및 중첩 처리

여러 예외를 한 번에 처리하거나, 특정 예외에 대해서만 별도의 처리가 필요한 경우, except 구문을 중첩하거나 다중 except 블록을 활용할 수 있습니다.
또한, 예외 발생 시 필요한 정리(clean-up) 작업은 finally 블록이나 with 구문을 통해 자동으로 처리할 수 있습니다.

사용자 정의 예외 클래스

내부 로직에 특화된 예외 상황을 더 명확하게 처리하기 위해, 파이썬은 사용자가 직접 예외 클래스를 정의할 수 있도록 지원합니다. 사용자 정의 예외 클래스는 기본 Exception 클래스를 상속받아 구현하며, 에러 메시지나 오류 코드를 추가하여 보다 구체적인 예외 정보를 제공할 수 있습니다.

예제: 사용자 정의 예외 클래스 구현

다음은 사용자 정의 예외 클래스를 구현하고 사용하는 예제입니다.

class NegativeValueError(Exception):
    """음수 값이 입력될 경우 발생하는 사용자 정의 예외 클래스"""
    def __init__(self, value, message="음수는 허용되지 않습니다."):
        self.value = value
        self.message = message
        super().__init__(self.message)

def check_positive(value):
    if value < 0:
        raise NegativeValueError(value)
    return f"{value}는 양수입니다."

try:
    print(check_positive(-5))
except NegativeValueError as e:
    print(f"오류 발생: {e.message} (입력값: {e.value})")

이 예제에서는 음수 값이 입력될 경우 NegativeValueError 예외가 발생하도록 하여, 보다 명확한 오류 메시지와 함께 문제를 처리할 수 있습니다.

로깅을 통한 오류 기록 및 모니터링

로깅(logging)은 프로그램 실행 중 발생하는 이벤트, 오류, 경고 등을 기록하여 문제 발생 시 원인을 분석하고, 시스템 상태를 모니터링하는 데 필수적입니다. 로깅을 적절히 활용하면, 개발 및 운영 단계에서 오류를 빠르게 파악하고 대응할 수 있습니다.

파이썬 로깅 모듈 활용

파이썬의 내장 logging 모듈은 다양한 로그 레벨(DEBUG, INFO, WARNING, ERROR, CRITICAL)을 제공하며, 로그 포맷과 출력 위치(콘솔, 파일 등)를 설정할 수 있습니다.

import logging

# 로그 설정: 로그 레벨, 포맷, 출력 위치 등을 설정합니다.
logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s - %(levelname)s - %(message)s',
                    filename='app.log',
                    filemode='w')

def divide(a, b):
    try:
        result = a / b
    except ZeroDivisionError:
        logging.error("0으로 나누기를 시도하였습니다.", exc_info=True)
        return None
    else:
        logging.info(f"정상적으로 계산되었습니다: {a} / {b} = {result}")
        return result

divide(10, 0)
divide(10, 2)

위 예제에서는 0으로 나누기 시도를 로깅하고, 정상적인 계산 결과 역시 로그에 기록합니다. exc_info=True 옵션은 예외의 상세 정보를 로그에 포함시켜 디버깅에 도움을 줍니다.

디버깅 도구 및 방어적 프로그래밍 기법

파이썬에서는 다양한 디버깅 도구와 방법을 통해 문제를 신속하게 해결할 수 있습니다.

pdb (파이썬 디버거): 코드 중단, 변수 상태 확인, 단계별 실행 등을 지원합니다.
IDE 내장 디버거: PyCharm, VSCode 등 최신 IDE는 강력한 디버깅 기능을 제공하여, 코드 실행 흐름을 시각적으로 파악할 수 있습니다.
로깅과 프린트 디버깅: 코드 중간중간 로깅이나 print 문을 삽입하여 변수 값이나 함수 호출 상태를 확인하는 방법도 유용합니다.

import pdb

def complex_function(x, y):
    pdb.set_trace()  # 디버깅 시작점
    result = x + y
    return result

complex_function(3, 4)

pdb.set_trace()를 통해 디버거를 활성화하면, 명령어 입력으로 코드의 흐름을 제어할 수 있어, 오류 원인을 신속하게 파악할 수 있습니다.

방어적 프로그래밍 기법

방어적 프로그래밍(Defensive Programming)은 프로그램의 안정성을 높이기 위해, 예상치 못한 상황이나 입력에 대해 미리 대비하는 기법입니다. 주요 기법은 다음과 같습니다.

입력 검증: 사용자 입력이나 외부 데이터를 철저하게 검증하여, 예상치 못한 데이터로 인한 오류를 예방합니다.
예외 처리 강화: 가능한 모든 예외 상황을 고려하여 try, except 블록을 작성하고, 적절한 로그와 에러 메시지를 제공하여 문제를 쉽게 추적할 수 있도록 합니다.
어설션(assertions): 코드 실행 중 특정 조건이 만족되는지 확인하여, 조건이 충족되지 않을 경우 즉시 프로그램을 중단하고 문제를 확인할 수 있습니다.

def process_data(data):
    # 데이터가 리스트인지 확인
    assert isinstance(data, list), "데이터는 리스트 형식이어야 합니다."
    # 리스트가 비어 있지 않은지 확인
    assert len(data) > 0, "리스트가 비어 있습니다."
    # 데이터 처리 로직
    return [x * 2 for x in data]

try:
    result = process_data([])
except AssertionError as e:
    print("어설션 실패:", e)

위 예제에서는 어설션을 활용하여 데이터가 올바른 형식과 조건을 만족하는지 확인하고, 그렇지 않을 경우 오류 메시지를 출력하여 문제를 조기에 발견할 수 있도록 합니다.

결론 및 향후 학습 방향

이번 포스팅에서는 파이썬의 예외 처리 및 디버깅 기법에 대해 심도 있게 살펴보았습니다.

예외 처리: try, except, finally 블록을 이용하여 예상치 못한 오류를 안전하게 처리하고, 사용자 정의 예외 클래스를 통해 구체적인 에러 상황을 관리할 수 있습니다.
로깅: 내장 logging 모듈을 활용하여 프로그램 실행 중 발생하는 이벤트를 기록하고, 문제 발생 시 원인을 신속하게 분석할 수 있습니다.
디버깅 도구: pdb와 같은 디버거를 활용하거나 IDE 내장 디버거를 통해 코드 실행 흐름과 변수 상태를 확인하며, 방어적 프로그래밍 기법을 도입하여 입력 검증, 어설션 등을 통해 안정성을 높일 수 있습니다.

오류 처리와 디버깅은 단순히 에러가 발생했을 때 문제를 해결하는 것을 넘어서, 프로그램의 전반적인 안정성과 신뢰성을 높이는 핵심 요소입니다. 지속적인 테스트와 코드 리뷰, 그리고 다양한 디버깅 전략을 통해, 더욱 견고하고 유지보수가 용이한 소프트웨어를 구축할 수 있습니다. 앞으로도 최신 디버깅 도구와 로깅 기법을 적극적으로 활용하여, 예외 상황에 유연하게 대처할 수 있는 개발 역량을 키워나가시길 바랍니다.

이 블로그 검색

H20. 과학, 수학, 경제, Python, 운세 꿈해몽 역학