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
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
utf8mb4VARCHAR, 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
-
Usa la
DYNAMICformato de fila (el predeterminado desde MySQL 5.7).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
Indexa un prefijo de la columna; funciona con índices no únicos.
CREATE INDEX idx_users_bio ON users (bio(191));
-
Acorta la columna si no necesitas valores largos, por ejemplo
VARCHAR(191)para un correo electrónico indexado enutf8mb4por debajo del límite de 767 bytes.
Errores relacionados
Más errores de claves y restricciones
1062Entrada duplicada para la clave1452Error de clave foránea: no se puede añadir la fila hija1451Error de clave foránea: no se puede eliminar la fila padre1216No se puede añadir o actualizar una fila hija1217No se puede eliminar o actualizar una fila padre1215No se puede añadir la restricción de clave foránea3780Las columnas de clave foránea son incompatibles1822Falta un índice para la restricción de clave foránea
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.
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.