MySQL-Fehler 1071: Der angegebene Schlüssel war zu lang
Ein Index ist breiter, als InnoDB erlaubt (3072 Bytes oder 767 Bytes bei älteren Zeilenformaten), typischerweise bei einem langen utf8mb4 VARCHAR.
- Fehlernummer
1071- Name
ER_TOO_LONG_KEY- SQLSTATE
42000- Kategorie
- Schlüssel und Constraints
Was es bedeutet
Die maximale Schlüssellänge zählt Bytes, nicht Zeichen. Mit utf8mb4 kann jedes Zeichen 4 Bytes belegen, also VARCHAR(255) braucht bis zu 1020 Bytes pro Spalte. InnoDB mit dem DYNAMIC oder COMPRESSED Zeilenformat erlaubt 3072 Bytes pro Index; die älteren COMPACT und REDUNDANT Formate erlauben 767, was der Punkt ist, an dem VARCHAR(255) in utf8mb4 fehlschlägt.
Häufige Ursachen
- Ein eindeutiger Index auf einer langen
utf8mb4VARCHAR, besonders in MySQL 5.6 oder mit altem Zeilenformat. - Ein zusammengesetzter Index, dessen Spalten zusammen über dem Limit liegen.
Wie du es behebst
-
Verwende das
DYNAMICZeilenformat (der Standard seit MySQL 5.7).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
Indiziere ein Präfix der Spalte, was bei nicht eindeutigen Indizes funktioniert.
CREATE INDEX idx_users_bio ON users (bio(191));
-
Verkürze die Spalte, wenn lange Werte nicht gebraucht werden, zum Beispiel
VARCHAR(191)für eine indexierte E-Mail inutf8mb4unter dem 767-Byte-Limit.
Zugehörige Fehler
Weitere Fehler bei Schlüsseln und Constraints
1062Doppelter Eintrag für Schlüssel1452Fremdschlüssel schlägt fehl: untergeordnete Zeile kann nicht hinzugefügt werden1451Fremdschlüssel schlägt fehl: übergeordnete Zeile kann nicht gelöscht werden1216Kann keine untergeordnete Zeile hinzufügen oder aktualisieren1217Kann eine übergeordnete Zeile nicht löschen oder aktualisieren: Ein Fremdschlüssel-Constraint schlägt fehl1215Fremdschlüssel-Constraint kann nicht hinzugefügt werden3780Fremdschlüsselspalten sind inkompatibel1822Fehlender Index für Fremdschlüssel-Constraint
Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
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.