// Referência de erro do MySQL

Erro do MySQL 1054: Coluna desconhecida na lista de campos

A instrução se refere a uma coluna que não existe nas tabelas que ela menciona, ou a uma que não está visível naquele ponto da consulta.

Número do erro
1054
Nome
ER_BAD_FIELD_ERROR
SQLSTATE
42S22
Categoria
Bancos de dados, tabelas e colunas
Mensagem de erro
Unknown column '%s' in '%s'

O que significa

O MySQL não conseguiu resolver um nome de coluna. A segunda parte da mensagem indica onde: in 'field list' (a lista de seleção ou SET), in 'where clause', in 'on clause', in 'order clause' e assim por diante.

Um caso clássico: uma string escrita com aspas duplas no modo ANSI_QUOTES, ou com crases por engano, é interpretada como um nome de coluna.

Causas comuns

  • Um erro de digitação, ou uma coluna que foi renomeada ou nunca adicionada.
  • Usar um alias da lista de seleção em WHERE, o qual é executado antes da lista de seleção ser calculada.
  • Um valor de string escrito entre crases em vez de aspas simples, então active é interpretado como um nome de coluna em vez do texto 'active'.
  • Referenciar uma coluna de uma tabela que ainda não está no JOIN, ou usar JOIN ... USING e então qualificando a coluna mesclada.
  • Em um gatilho, faltando NEW. ou OLD. antes da coluna.

Como corrigir

  1. Liste as colunas da tabela.

    SHOW COLUMNS FROM orders;
  2. Use aspas para valores de string e crases apenas para nomes.

    SELECT * FROM users WHERE status = 'active';
  3. Repita a expressão em WHERE, ou use HAVING ou uma tabela derivada, em vez de um alias na lista de seleção.

    SELECT price * qty AS total FROM order_lines HAVING total > 100;
  4. Se a coluna for nova, adicione-a.

    ALTER TABLE orders ADD COLUMN shipped_at DATETIME NULL;

Reproduza com segurança

CREATE TEMPORARY TABLE t (a INT);
SELECT b FROM t;  -- ERROR 1054 (42S22): Unknown column 'b' in 'field list'

Erros relacionados

Mais erros de bancos de dados, tabelas e colunas

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.