Ir para o conteúdo
Exceções de PythonErro
pandas KeyError: column not found

pandas KeyError: coluna não encontrada

O acesso a uma coluna de um DataFrame falhou porque o nome de coluna especificado não existe.

python

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.

Exemplo

import pandas as pd; df = pd.DataFrame(); df['nonexistent']
Documentação Oficial

Códigos de Erro Relacionados