Ошибка MySQL 1071: Указанный ключ слишком длинный
Индекс шире, чем позволяет InnoDB (3072 байта, или 767 байтов с более старыми форматами строк), обычно на длинном utf8mb4 VARCHAR.
- Номер ошибки
1071- Имя
ER_TOO_LONG_KEY- SQLSTATE
42000- Категория
- Ключи и ограничения
Что это значит
Максимальная длина ключа учитывает байты, а не символы. С utf8mb4 каждый символ может занимать 4 байта, поэтому VARCHAR(255) требует до 1020 байт на столбец. InnoDB с DYNAMIC или COMPRESSED формат строк допускает 3072 байта на индекс; старый COMPACT и REDUNDANT форматы допускают 767, откуда и VARCHAR(255) в utf8mb4 возникает ошибка.
Распространённые причины
- Уникальный индекс по длинному
utf8mb4VARCHAR, особенно в MySQL 5.6 или при старом формате строк. - Составной индекс, столбцы которого в сумме превышают лимит.
Как исправить
-
Используйте
DYNAMICформат строк (по умолчанию начиная с MySQL 5.7).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
Индексируйте префикс столбца — это работает для неуникальных индексов.
CREATE INDEX idx_users_bio ON users (bio(191));
-
Укоротите столбец, если длинные значения не нужны, например
VARCHAR(191)для индексированного email вutf8mb4укладывается в лимит 767 байт.
Связанные ошибки
Больше ошибок ключей и ограничений
1062Повторяющаяся запись для ключа1452Ошибка внешнего ключа: невозможно добавить дочернюю строку1451Ошибка внешнего ключа: невозможно удалить родительскую строку1216Невозможно добавить или обновить дочернюю строку1217Невозможно удалить или обновить родительскую строку1215Невозможно добавить ограничение внешнего ключа3780Столбцы внешнего ключа несовместимы1822Отсутствует индекс для ограничения внешнего ключа
Код и текст сообщения взяты из Справочник сообщений об ошибках MySQL 8.4. Смотрите весь Список ошибок MySQL или поиск по всем ошибкам баз данных.
Работа с MySQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.