pandas KeyError: coluna não encontrada

O que causa este erro

O nome de coluna referenciado não existe no DataFrame. Causas comuns: erros de digitação, espaços extras nos nomes de colunas, diferença de maiúsculas/minúsculas, ou a coluna foi removida/renomeada em uma etapa anterior do pipeline.

Como corrigir

Verifique as colunas disponíveis: df.columns.tolist(). Remova espaços: df.columns = df.columns.str.strip(). Use df.get('col', default) para acesso seguro. Verifique os nomes de colunas após read_csv() ou transformações.

import pandas as pd; df = pd.DataFrame(); df['nonexistent']