// SQLite-Fehlerreferenz

SQLITE_CONSTRAINT_FOREIGNKEY: FOREIGN KEY-Einschränkung fehlgeschlagen

Ein Schreibvorgang würde eine untergeordnete Zeile auf einen nicht existierenden übergeordneten Eintrag verweisen lassen oder einen übergeordneten Eintrag löschen, der noch untergeordnete Einträge hat. Fremdschlüssel müssen pro Verbindung aktiviert werden.

Ergebniscode
SQLITE_CONSTRAINT_FOREIGNKEY
Name
787
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
FOREIGN KEY constraint failed

Was es bedeutet

SQLITE_CONSTRAINT_FOREIGNKEY (787) bedeutet, dass eine Fremdschlüsselprüfung fehlgeschlagen ist. SQLite erzwingt Fremdschlüssel nur bei Verbindungen, die PRAGMA foreign_keys = ON; standardmäßig ist es für Abwärtskompatibilität deaktiviert, weshalb derselbe Einfügevorgang in einem Tool erfolgreich sein kann und in einem anderen fehlschlägt.

Die Meldung sagt nicht, welcher Schlüssel fehlgeschlagen ist. PRAGMA foreign_key_check listet jede verletzende Zeile auf.

Häufige Ursachen

  • Einfügen einer Kindzeile, deren Eltern-ID nicht existiert.
  • Löschen oder Aktualisieren einer Elternzeile, die noch Kinder hat, ohne ON DELETE CASCADE oder SET NULL.
  • Tabellen werden in der falschen Reihenfolge geladen: Kinder vor Eltern.
  • Aufgeschobene Constraints (DEFERRABLE INITIALLY DEFERRED) schlagen fehl bei COMMIT.

Wie du es behebst

  1. Finde die Zeilen, die einen Fremdschlüssel verletzen.

    PRAGMA foreign_key_check;
    PRAGMA foreign_key_list(orders);
  2. Füge übergeordnete Zeilen vor den untergeordneten ein oder lösche untergeordnete vor den übergeordneten.

  3. Bei Massenladungen verlagerst du die Prüfung auf das Ende der Transaktion.

    BEGIN;
    PRAGMA defer_foreign_keys = ON;
    -- load tables in any order
    COMMIT;
  4. Soll das Löschen eines Elternteils auch seine Kinder entfernen, deklariere die Aktion am Fremdschlüssel.

    CREATE TABLE orders (
        id          INTEGER PRIMARY KEY,
        customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE
    );

Sicher reproduzieren

PRAGMA foreign_keys = ON;
CREATE TABLE p (id INTEGER PRIMARY KEY);
CREATE TABLE c (pid INTEGER REFERENCES p(id));
INSERT INTO c VALUES (1);  -- Runtime error: FOREIGN KEY constraint failed (19)

Fragen

Warum werden Fremdschlüssel in meiner SQLite-Datenbank nicht durchgesetzt?

Die Durchsetzung erfolgt pro Verbindung und ist standardmäßig aus. Jede Verbindung muss PRAGMA foreign_keys = ON setzen, und das lässt sich nicht innerhalb einer Transaktion ändern.

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.