// Referência de erro do MySQL

Erro do MySQL 1048: A coluna não pode ser nula

Um INSERT ou UPDATE colocou NULL em uma coluna declarada NOT NULL. Forneça um valor, dê um padrão à coluna ou permita NULL.

Número do erro
1048
Nome
ER_BAD_NULL_ERROR
SQLSTATE
23000
Categoria
Chaves e restrições
Mensagem de erro
Column '%s' cannot be null

O que significa

A coluna indicada é NOT NULL, e a instrução o definiu explicitamente como NULL (ou para uma expressão que resultou em NULL). Omitir a coluna usa o valor padrão dela; se ela não tiver nenhum, você leva o 1364, no modo estrito.

Causas comuns

  • Código do aplicativo passando null para um campo obrigatório.
  • Uma INSERT ... SELECT ou UPDATE ... JOIN onde uma busca não encontrou linha e produziu NULL.
  • Uma importação CSV onde campos vazios mapeiam para NULL.

Como corrigir

  1. Forneça um valor ou substitua um para NULL.

    INSERT INTO customers (name, country) VALUES ('Ada', COALESCE(@country, 'GB'));
  2. Dê à coluna um valor padrão e omita-a do insert.

    ALTER TABLE customers MODIFY country CHAR(2) NOT NULL DEFAULT 'GB';
  3. Se o valor realmente puder ser desconhecido, permita NULL.

    ALTER TABLE customers MODIFY country CHAR(2) NULL;

Reproduza com segurança

CREATE TEMPORARY TABLE t (a INT NOT NULL);
INSERT INTO t VALUES (NULL);  -- ERROR 1048 (23000): Column 'a' cannot be null

Erros relacionados

Mais erros de chaves e restrições

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.