// Referencia de errores de MySQL

Error de MySQL 1071: la clave especificada era demasiado larga

Un índice es más ancho de lo que InnoDB permite (3072 bytes, o 767 bytes con formatos de fila antiguos), típicamente en un VARCHAR largo utf8mb4.

Número de error
1071
Nombre
ER_TOO_LONG_KEY
SQLSTATE
42000
Categoría
Claves y restricciones
Mensaje de error
Specified key was too long; max key length is %d bytes

Qué significa

La longitud máxima de la clave cuenta bytes, no caracteres. Con utf8mb4 cada carácter puede ocupar 4 bytes, por lo que VARCHAR(255) necesita hasta 1020 bytes por columna. InnoDB con el DYNAMIC o COMPRESSED formato de fila permite 3072 bytes por índice; los formatos antiguos COMPACT y REDUNDANT permiten 767, que es donde VARCHAR(255) en utf8mb4 falla.

Causas comunes

  • Un índice único en un utf8mb4 VARCHAR, especialmente en MySQL 5.6 o con un formato de fila antiguo.
  • Un índice compuesto cuyas columnas suman más que el límite.

Cómo solucionarlo

  1. Usa la DYNAMIC formato de fila (el predeterminado desde MySQL 5.7).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. Indexa un prefijo de la columna; funciona con índices no únicos.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. Acorta la columna si no necesitas valores largos, por ejemplo VARCHAR(191) para un correo electrónico indexado en utf8mb4 por debajo del límite de 767 bytes.

Errores relacionados

Más errores de claves y restricciones

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.