// Referência de erro do MySQL

Erro do MySQL 1071: A chave especificada era muito longa

Um índice é mais largo do que o InnoDB permite (3072 bytes, ou 767 bytes com formatos de linha mais antigos), normalmente em um VARCHAR utf8mb4 longo.

Número do erro
1071
Nome
ER_TOO_LONG_KEY
SQLSTATE
42000
Categoria
Chaves e restrições
Mensagem de erro
Specified key was too long; max key length is %d bytes

O que significa

O comprimento máximo da chave conta bytes, não caracteres. Com utf8mb4 cada caractere pode ocupar 4 bytes, então VARCHAR(255) precisa de até 1020 bytes por coluna. InnoDB com o DYNAMIC ou COMPRESSED formato de linha permite 3072 bytes por índice; os formatos antigos COMPACT e REDUNDANT permitem 767, que é onde VARCHAR(255) em utf8mb4 falha.

Causas comuns

  • Um índice único em um utf8mb4 VARCHAR, especialmente no MySQL 5.6 ou com um formato de linha antigo.
  • Um índice composto cujas colunas somam mais do que o limite.

Como corrigir

  1. Use o DYNAMIC formato de linha (o padrão desde o MySQL 5.7).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. Indexar um prefixo da coluna, o que funciona para índices não exclusivos.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. Encurte a coluna se valores longos não forem necessários, por exemplo VARCHAR(191) para um e-mail indexado em utf8mb4 dentro do limite de 767 bytes.

Erros relacionados

Mais erros de chaves e restrições

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.