// Référence des erreurs MySQL

Erreur MySQL 1071 : La clé spécifiée était trop longue

Un index est plus large que ce qu'InnoDB autorise (3072 octets, ou 767 octets avec d'anciens formats de ligne), généralement sur un long VARCHAR utf8mb4.

Numéro d'erreur
1071
Nom
ER_TOO_LONG_KEY
SQLSTATE
42000
Catégorie
Clés et contraintes
Message d'erreur
Specified key was too long; max key length is %d bytes

Ce que cela signifie

La longueur maximale de la clé se compte en octets, pas en caractères. Avec utf8mb4 chaque caractère peut prendre 4 octets, donc VARCHAR(255) nécessite jusqu'à 1020 octets par colonne. InnoDB avec le DYNAMIC ou COMPRESSED format de ligne permet 3072 octets par index ; les anciens COMPACT et REDUNDANT formats permettent 767, ce qui est l'endroit où VARCHAR(255) dans utf8mb4 échoue.

Causes courantes

  • Un index unique sur un long utf8mb4 VARCHAR, surtout sur MySQL 5.6 ou avec un ancien format de ligne.
  • Un index composite dont les colonnes dépassent, cumulées, la limite.

Comment le corriger

  1. Utilisez le DYNAMIC format de ligne (le défaut depuis MySQL 5.7).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. Indexez un préfixe de la colonne, ce qui fonctionne pour les index non uniques.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. Raccourcissez la colonne si des valeurs longues ne sont pas nécessaires, par exemple VARCHAR(191) pour un email indexé dans utf8mb4 sous la limite de 767 octets.

Erreurs liées

Plus d'erreurs de clés et de contraintes

Le code et le texte du message sont issus de Référence des messages d'erreur MySQL 8.4. Parcourir la liste complète Liste des erreurs MySQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur MySQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour MySQL et les autres bases de données que vous utilisez.