// справочник ошибок MySQL

Ошибка MySQL 1071: Указанный ключ слишком длинный

Индекс шире, чем позволяет InnoDB (3072 байта, или 767 байтов с более старыми форматами строк), обычно на длинном utf8mb4 VARCHAR.

Номер ошибки
1071
Имя
ER_TOO_LONG_KEY
SQLSTATE
42000
Категория
Ключи и ограничения
Сообщение об ошибке
Specified key was too long; max key length is %d bytes

Что это значит

Максимальная длина ключа учитывает байты, а не символы. С utf8mb4 каждый символ может занимать 4 байта, поэтому VARCHAR(255) требует до 1020 байт на столбец. InnoDB с DYNAMIC или COMPRESSED формат строк допускает 3072 байта на индекс; старый COMPACT и REDUNDANT форматы допускают 767, откуда и VARCHAR(255) в utf8mb4 возникает ошибка.

Распространённые причины

  • Уникальный индекс по длинному utf8mb4 VARCHAR, особенно в MySQL 5.6 или при старом формате строк.
  • Составной индекс, столбцы которого в сумме превышают лимит.

Как исправить

  1. Используйте DYNAMIC формат строк (по умолчанию начиная с MySQL 5.7).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. Индексируйте префикс столбца — это работает для неуникальных индексов.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. Укоротите столбец, если длинные значения не нужны, например VARCHAR(191) для индексированного email в utf8mb4 укладывается в лимит 767 байт.

Связанные ошибки

Больше ошибок ключей и ограничений

Код и текст сообщения взяты из Справочник сообщений об ошибках MySQL 8.4. Смотрите весь Список ошибок MySQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с MySQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.