// Referência de erro do PostgreSQL

PostgreSQL 23502: valor nulo viola restrição de não-nulo

Um INSERT ou UPDATE deixou uma coluna NOT NULL vazia, geralmente porque a coluna foi omitida e não tem padrão.

SQLSTATE
23502
Nome
not_null_violation
Categoria
Violação de restrição de integridade
Mensagem de erro
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

O que significa

A NOT NULL a coluna deve ter um valor em cada linha. 23502 significa que a nova linha ou a linha atualizada tinha NULL lá, seja explicitamente ou porque a coluna foi deixada de fora de um INSERT e seu valor padrão é NULL.

O DETAIL a linha mostra a linha inteira que falhou. O PostgreSQL 13 e posteriores nomeiam a tabela na mensagem; as versões mais antigas dizem apenas null value in column "email" violates not-null constraint.

Causas comuns

  • O INSERT não lista a coluna e a coluna não possui DEFAULT.
  • O aplicativo enviou NULL, por exemplo, um campo não definido ou uma busca que falha.
  • INSERT ... SELECT ou um UPDATE com uma subconsulta que não retornou nenhuma linha, produzindo NULL.
  • Uma coluna adicionada com NOT NULL que o código existente não conhece.

Como corrigir

  1. Forneça o valor ou dê à coluna um valor padrão.

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. Use COALESCE quando uma busca ou expressão pode retornar NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. Se a coluna deve permitir valores ausentes, remova a restrição.

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

Reproduza com segurança

CREATE TEMP TABLE u (id int, email text NOT NULL);
INSERT INTO u (id) VALUES (1);  -- ERROR: null value in column "email" of relation "u" violates not-null constraint

Erros relacionados

Mais erros de violação de restrição de integridade

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

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

Trabalhe com PostgreSQL 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 PostgreSQL e os outros bancos de dados que você usa.