// SQLite-Fehlerreferenz

SQLITE_CONSTRAINT_NOTNULL: NOT NULL-Einschränkung fehlgeschlagen

Ein INSERT oder UPDATE hat versucht, NULL in einer NOT NULL-Spalte zu speichern, oft weil die Spalte ausgelassen wurde und keinen Standardwert hat. Die Nachricht benennt sie.

Ergebniscode
SQLITE_CONSTRAINT_NOTNULL
Name
1299
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
NOT NULL constraint failed: users.name

Was es bedeutet

SQLITE_CONSTRAINT_NOTNULL (1299) bedeutet ein NOT NULL die Spalte NULL erhalten hätte. Das passiert, wenn du NULL explizit übergibst, und auch wenn ein INSERT eine NOT NULL Spalte aus, die keinen DEFAULT, weil die fehlende Spalte NULL erhält.

Häufige Ursachen

  • das INSERT Spaltenliste lässt eine erforderliche Spalte ohne Standardwert aus.
  • Die Anwendung hat NULL oder None für einen Wert übergeben, den sie nicht hatte.
  • Hinzufügen einer NOT NULL Spalte bei einem Neuaufbau der Tabelle, ohne sie für bestehende Zeilen zu füllen.

Wie du es behebst

  1. Gib einen Wert für die Spalte an oder lege einen Standardwert fest.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. Prüfe, welche Spalten erforderlich sind.

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. Um einer bestehenden Tabelle eine erforderliche Spalte hinzuzufügen, gib ihr einen Standardwert, damit bestehende Zeilen einen Wert erhalten.

    ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

Sicher reproduzieren

CREATE TABLE users (email TEXT, name TEXT NOT NULL);
INSERT INTO users (email) VALUES ('a@x');  -- Runtime error: NOT NULL constraint failed: users.name (19)

Zugehörige Fehler

Weitere Fehler bei erweiterten Ergebniscodes

Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQLite 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 SQLite und die anderen Datenbanken, mit denen du arbeitest.