Henry's Algorithm

💬 KeyError: 'column_name'
데이터 다루다 보면 꼭 한 번은 마주치는 이 에러.
왜 발생하고, 어떻게 예방할 수 있을까요?

❗ 에러 메시지 예시

KeyError: 'price'

→ 없는 key(또는 column)를 찾으려 해서 발생한 오류입니다.

🔍 원인: 딕셔너리나 DataFrame에서 없는 키를 호출했을 때

my_dict = {'a': 1, 'b': 2}
print(my_dict['c'])    # ❌ KeyError 발생

또는 Pandas에서:

import pandas as pd

df = pd.DataFrame({
    'name': ['a', 'b'],
    'value': [1, 2]
})

df['price']    # ❌ 'price'라는 컬럼이 없음

🧪 자주 발생하는 사례

✅ 오타

df['Price']    # 대소문자 구분 때문에 오류 발생

✅ drop(), groupby(), merge() 등에서 존재하지 않는 컬럼 지정

df.drop(columns=['price'])  # 없는 컬럼이면 KeyError

🛠️ 해결 방법

✔ 컬럼 존재 여부 확인 후 사용

if 'price' in df.columns:
    df['price']
else:
    print("컬럼이 없습니다.")

✔ get() 사용 (딕셔너리에서)

value = my_dict.get('c', 0)  # 없으면 기본값 0

✔ try-except로 에러 방지

try:
    df['price']
except KeyError:
    print("해당 컬럼이 존재하지 않습니다.")

✅ 마무리 정리

• KeyError는 존재하지 않는 키나 컬럼명을 호출할 때 발생합니다.
• 오타, 대소문자 구분, 컬럼 삭제 후 호출 등의 실수가 원인일 수 있습니다.
• 호출 전에 in으로 존재 여부를 체크하거나, get()을 사용해 안전하게 처리하세요.

📘 다음에 보면 좋은 글

🔹 [에러 해결] ValueError: could not convert string to float – 왜 이런 에러가 날까?

❗ 에러 메시지의 정체

데이터 분석 중 이런 에러를 본 적 있나요?

ValueError: could not convert string to float: 'abc'

처음엔 당황스럽지만, 이 에러는 매우 흔합니다.
이유는 간단합니다. 파이썬이 문자열을 숫자로 바꾸지 못해서 그래요.

🔍 원인: 문자열인데 float로 바꾸려 해서

float() 함수나 astype(float)를 사용할 때,
숫자처럼 생기지 않은 문자열이 들어오면 에러가 납니다.

예시:

float('123.45')     # ✅ 가능
float('abc')        # ❌ ValueError 발생

🧪 자주 발생하는 사례

판다스에서 숫자가 들어간 컬럼처럼 보이지만, 실제로는
쉼표, 문자 등이 섞여 있는 경우가 많습니다.

import pandas as pd

df = pd.DataFrame({
    'price': ['1000', '2000', '1,500', 'free']
})

df['price'] = df['price'].astype(float)

결과:

ValueError: could not convert string to float: '1,500'

🛠️ 해결 방법

✔ 방법 1: 쉼표 제거하기

df['price'] = df['price'].str.replace(',', '')
df['price'] = df['price'].astype(float)

✔ 방법 2: 문자 제거하고 숫자만 변환 (에러는 NaN 처리)

df['price'] = pd.to_numeric(df['price'].str.replace(',', ''), errors='coerce')

✅ 마무리 정리

• 이 에러는 문자열을 숫자로 바꾸는 과정에서 발생합니다.
• 특히 쉼표, 문자 등 숫자가 아닌 요소가 섞여 있으면 오류가 납니다.
• 전처리로 깨끗하게 만들거나, 오류를 NaN으로 처리하면 해결됩니다.