// PostgreSQL-Fehlerreferenz

PostgreSQL 23502: Nullwert verletzt NOT-NULL-Einschränkung

Ein INSERT oder UPDATE ließ eine NOT NULL-Spalte leer, oft weil die Spalte ausgelassen wurde und keinen Standardwert hat.

SQLSTATE
23502
Name
not_null_violation
Kategorie
Integritätsbedingungsverletzung
Fehlermeldung
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

Was es bedeutet

A NOT NULL Spalte muss in jeder Zeile einen Wert haben. 23502 bedeutet, dass die neue oder aktualisierte Zeile NULL hatte, entweder ausdrücklich oder weil die Spalte in einem INSERT fehlte und ihr Standardwert ist NULL.

das DETAIL Die Zeile zeigt die gesamte fehlerhafte Zeile. PostgreSQL 13 und neuer nennen die Tabelle in der Meldung; ältere Versionen sagen nur null value in column "email" violates not-null constraint.

Häufige Ursachen

  • das INSERT listet die Spalte nicht auf und die Spalte hat keinen DEFAULT.
  • Die Anwendung sendete NULL, zum Beispiel ein nicht gesetztes Feld oder ein fehlgeschlagener Nachschlagevorgang.
  • INSERT ... SELECT oder ein UPDATE mit einer Unterabfrage, die keine Zeile zurückgegeben hat, was zu NULL.
  • Eine Spalte, die mit NOT NULL von der der bestehende Code nichts weiß.

Wie du es behebst

  1. Lege den Wert fest oder gib der Spalte einen Standardwert.

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. Verwende COALESCE wenn ein Nachschlagevorgang oder Ausdruck zurückgeben kann NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. Wenn die Spalte fehlende Werte erlauben soll, entferne die Einschränkung.

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

Sicher reproduzieren

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

Zugehörige Fehler

Weitere Fehler bei der Verletzung von Integritätsbedingungen

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.