// MySQL-Fehlerreferenz

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
Fehlermeldung
Specified key was too long; max key length is %d bytes

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 utf8mb4 VARCHAR, besonders in MySQL 5.6 oder mit altem Zeilenformat.
  • Ein zusammengesetzter Index, dessen Spalten zusammen über dem Limit liegen.

Wie du es behebst

  1. Verwende das DYNAMIC Zeilenformat (der Standard seit MySQL 5.7).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. Indiziere ein Präfix der Spalte, was bei nicht eindeutigen Indizes funktioniert.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. Verkürze die Spalte, wenn lange Werte nicht gebraucht werden, zum Beispiel VARCHAR(191) für eine indexierte E-Mail in utf8mb4 unter dem 767-Byte-Limit.

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.