// MySQL-Fehlerreferenz

MySQL-Fehler 1215: Fremdschlüssel-Constraint kann nicht hinzugefügt werden

MySQL hat eine FOREIGN KEY-Definition abgelehnt: Die Spaltentypen unterscheiden sich, die übergeordnete Tabelle ist nicht indiziert oder die Tabellen-Engine unterstützt keine Fremdschlüssel.

Fehlernummer
1215
Name
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
Kategorie
Schlüssel und Constraints
Fehlermeldung
Cannot add foreign key constraint

Was es bedeutet

1215 sagt, dass sich der Fremdschlüssel nicht anlegen ließ, aber nicht warum. MySQL 8.0 meldet stattdessen oft einen genaueren Fehler (3780 für inkompatible Spalten, 1822 für einen fehlenden übergeordneten Index, 1824 für eine fehlende übergeordnete Tabelle). Für die Details führe aus SHOW ENGINE INNODB STATUS und lies den LATEST FOREIGN KEY ERROR Abschnitt.

Häufige Ursachen

  • Die Kind- und Elternspalten haben unterschiedliche Typen, Vorzeichen (INT gegenüber INT UNSIGNED), Länge oder Zeichensatz und Kollation.
  • Die referenzierten Spalten sind kein Primärschlüssel oder stehen nicht am Anfang eines Index.
  • Eine der Tabellen verwendet MyISAM oder eine andere Engine ohne Unterstützung für Fremdschlüssel.
  • Die übergeordnete Tabelle existiert noch nicht, wenn die untergeordnete erstellt wird.
  • ON DELETE SET NULL auf einer Spalte, die als NOT NULL.

Wie du es behebst

  1. Lies den ausführlichen Grund.

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. Vergleiche die Spaltendefinitionen auf beiden Seiten und mache sie identisch.

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. Gleiche die Spaltentypen an und füge dann den Schlüssel hinzu.

    ALTER TABLE orders MODIFY customer_id INT UNSIGNED NOT NULL;
    ALTER TABLE orders ADD CONSTRAINT fk_orders_customer
      FOREIGN KEY (customer_id) REFERENCES customers (id);
  4. Konvertiere MyISAM-Tabellen in InnoDB.

    ALTER TABLE customers ENGINE = InnoDB;

Zugehörige Fehler

Weitere Fehler bei Schlüsseln und Constraints

Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

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