본문 바로가기
카테고리 없음

"KeyError" 발생 시 파이썬 딕셔너리 오류 해결법

by smartmove 2025. 3. 11.

파이썬에서 'KeyError'란?

파이썬에서 발생하는 KeyError는 딕셔너리에서 존재하지 않는 키를 참조하려 할 때 발생하는 오류입니다. 딕셔너리는 키와 값의 쌍으로 데이터를 저장하며, 특정 키를 이용해 값을 조회할 수 있습니다. 그러나 지정된 키가 딕셔너리에 존재하지 않으면 KeyError가 발생합니다. KeyError는 파이썬 프로그램에서 매우 흔하게 발생할 수 있는 오류 중 하나입니다. 이를 예방하려면 딕셔너리에 키가 존재하는지 확인하고 안전하게 접근하는 방법을 사용해야 합니다.

KeyError 발생 원인

KeyError는 딕셔너리에서 키를 잘못 참조하거나, 존재하지 않는 키를 사용하려 할 때 발생합니다. 다음은 KeyError가 발생하는 주요 원인입니다.

1. 존재하지 않는 키로 딕셔너리 접근하기

가장 흔한 원인은 딕셔너리에 없는 키로 값을 참조하려는 경우입니다. 이때 파이썬은 해당 키가 존재하지 않는다고 판단하고 KeyError를 발생시킵니다.

my_dict = {'name': 'Alice', 'age': 30}
print(my_dict['address'])  # KeyError: 'address'

위 코드에서는 `'address'`라는 키가 `my_dict` 딕셔너리에 없기 때문에 KeyError가 발생합니다.

2. 키를 동적으로 처리할 때 발생하는 문제

딕셔너리에서 키를 동적으로 처리하는 경우, 키가 항상 존재한다고 가정하고 값을 조회할 수 있습니다. 그러나 때로는 예기치 않게 키가 없을 수 있습니다.

my_dict = {'name': 'Alice', 'age': 30}
key = 'email'
print(my_dict[key])  # KeyError: 'email'

위 코드에서는 `key` 변수에 담긴 값이 딕셔너리에서 존재하지 않으면 KeyError가 발생합니다.

파이썬에서 KeyError를 피하는 방법

KeyError를 방지하는 방법은 여러 가지가 있습니다. 아래에서는 딕셔너리에서 안전하게 키에 접근하는 방법을 소개합니다.

1. 'in' 연산자를 사용하여 키 존재 여부 확인하기

딕셔너리에서 특정 키가 존재하는지 확인하려면 `in` 연산자를 사용할 수 있습니다. 이를 통해 키가 딕셔너리에 존재하는지 미리 확인하고 안전하게 값을 조회할 수 있습니다.

my_dict = {'name': 'Alice', 'age': 30}

if 'address' in my_dict:
    print(my_dict['address'])
else:
    print("주소 정보가 없습니다.")

위 코드에서는 `'address'`라는 키가 `my_dict` 딕셔너리에 존재하는지 확인한 후에 값을 조회하므로 KeyError가 발생하지 않습니다.

2. get() 메서드 사용하기

딕셔너리에서 키를 안전하게 조회하려면 `get()` 메서드를 사용하는 것이 좋습니다. `get()` 메서드는 키가 존재하지 않으면 기본값을 반환하므로 KeyError를 방지할 수 있습니다.

my_dict = {'name': 'Alice', 'age': 30}
result = my_dict.get('address', '주소 정보가 없습니다.')
print(result)

위 코드에서는 `'address'`라는 키가 딕셔너리에 없으면 기본값 `'주소 정보가 없습니다.'`가 반환됩니다. 이 방법은 KeyError를 피할 수 있는 안전한 방법입니다.

3. defaultdict 사용하기

파이썬의 `collections` 모듈에서 제공하는 `defaultdict`를 사용하면, 키가 존재하지 않을 때 자동으로 기본값을 반환하도록 할 수 있습니다. `defaultdict`는 키가 없을 경우 지정된 기본값을 반환하므로, KeyError를 예방할 수 있습니다.

from collections import defaultdict

my_dict = defaultdict(lambda: '주소 정보가 없습니다.')
my_dict['name'] = 'Alice'
my_dict['age'] = 30

print(my_dict['address'])  # '주소 정보가 없습니다.'

위 코드에서는 `defaultdict`를 사용하여 `'address'`라는 키가 없을 때 자동으로 `'주소 정보가 없습니다.'`가 반환됩니다.

4. try-except 문을 사용하여 예외 처리하기

딕셔너리에서 키가 없을 때 발생하는 KeyError를 처리하려면 `try-except` 문을 사용할 수 있습니다. `try` 블록에서 발생한 예외를 `except` 블록에서 처리하여 프로그램의 중단을 방지할 수 있습니다.

my_dict = {'name': 'Alice', 'age': 30}

try:
    print(my_dict['address'])
except KeyError:
    print("주소 정보가 없습니다.")

위 코드에서는 `try` 블록 내에서 발생하는 `KeyError`를 `except` 문으로 처리하여 오류를 피할 수 있습니다.

5. 키를 동적으로 처리할 때 예외를 미리 처리하기

동적으로 키를 처리할 때에는 예외가 발생할 가능성이 높습니다. 이럴 때는 `get()` 메서드나 `in` 연산자 등을 사용하여 미리 확인하고, 예외가 발생하지 않도록 처리할 수 있습니다.

my_dict = {'name': 'Alice', 'age': 30}
key = 'email'

if key in my_dict:
    print(my_dict[key])
else:
    print(f"{key} 정보가 없습니다.")

위 코드에서는 키가 딕셔너리에 존재하는지 확인한 후에 안전하게 값을 조회하므로 KeyError를 예방할 수 있습니다.

결론

KeyError는 파이썬 딕셔너리에서 존재하지 않는 키를 참조할 때 발생하는 오류입니다. 이를 방지하려면 키가 딕셔너리에 존재하는지 확인하고, 안전한 방법으로 값을 조회해야 합니다. `in` 연산자, `get()` 메서드, `defaultdict` 등을 사용하면 KeyError를 예방할 수 있습니다. 또한, `try-except` 문을 사용하여 예외를 처리하거나, 동적으로 키를 처리할 때 예외를 미리 처리하는 방식으로 안정성을 높일 수 있습니다. 이 방법들을 적절히 활용하면, 파이썬에서 딕셔너리 오류를 효과적으로 처리하고 프로그램의 안정성을 높일 수 있습니다.

티스토리툴바