// Référence des erreurs PostgreSQL

PostgreSQL 23502 : la valeur nulle enfreint la contrainte NOT NULL

Un INSERT ou UPDATE a laissé une colonne NOT NULL vide, souvent parce que la colonne a été omise et n'a pas de valeur par défaut.

SQLSTATE
23502
Nom
not_null_violation
Catégorie
Violation de contrainte d'intégrité
Message d'erreur
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

Ce que cela signifie

A NOT NULL la colonne doit avoir une valeur dans chaque ligne. 23502 signifie que la ligne nouvelle ou mise à jour avait NULL là, soit explicitement, soit parce que la colonne a été omise dans un INSERT et sa valeur par défaut est NULL.

Le DETAIL la ligne montre la ligne en échec entière. PostgreSQL 13 et suivants nomment la table dans le message ; les versions antérieures indiquent seulement null value in column "email" violates not-null constraint.

Causes courantes

  • Le INSERT ne liste pas la colonne et la colonne n'a pas de DEFAULT.
  • L'application a envoyé NULL, par exemple un champ non défini ou une recherche échouée.
  • INSERT ... SELECT ou un UPDATE avec une sous-requête qui n'a retourné aucune ligne, produisant NULL.
  • Une colonne ajoutée avec NOT NULL que le code existant ne connaît pas.

Comment le corriger

  1. Fournissez la valeur, ou donnez à la colonne une valeur par défaut.

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. Utilisez COALESCE lorsqu'une recherche ou une expression peut retourner NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. Si la colonne doit autoriser les valeurs manquantes, supprimez la contrainte.

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs de violation de contrainte d'intégrité

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.