본문 바로가기
프로그래밍언어/파이썬[Error]

[파이썬][Error] 044. KeyError - 'key' when using dict[key]

by about_IT 2025. 5. 28.
728x90

KeyError: 'key' 오류는 파이썬 딕셔너리에서 존재하지 않는 키에 접근할 때 발생합니다. dict['key']와 같이 특정 키로 값을 조회하려고 시도했으나, 해당 키가 딕셔너리에 존재하지 않으면 이 오류가 발생합니다.

이 오류는 특히 동적으로 데이터를 처리하거나, 외부 소스에서 받아온 데이터를 사전 처리 없이 바로 사용할 때 자주 발생합니다.

● 오류 발생 예시

my_dict = {"name": "Alice", "age": 30}
print(my_dict["gender"])

위 코드에서는 'gender'라는 키가 존재하지 않기 때문에 KeyError가 발생합니다.

● 주요 원인

  • 딕셔너리에 존재하지 않는 키에 접근
  • 입력 데이터의 키가 예상과 다를 때
  • 딕셔너리 초기화가 잘못되었거나, 키가 동적으로 생성되었을 때

● 해결 방법

  • dict.get('key') 메서드를 사용하여 기본값 반환
  • 조건문으로 키 존재 여부 확인: if 'key' in dict:
  • 예외 처리로 오류 방지: try-except 사용

● 예시 코드 (정상 처리)

my_dict = {"name": "Alice", "age": 30}
print(my_dict.get("gender", "unknown"))

● 결론

딕셔너리 키를 사용할 때는 해당 키가 실제로 존재하는지 확인하는 습관이 필요합니다. dict.get() 메서드를 이용하면 기본값을 지정할 수 있어 오류 없이 코드를 실행할 수 있으며, 안정적인 데이터 처리를 보장할 수 있습니다.

728x90