// Referência de erro do MySQL

Erro do MySQL 1062: Entrada duplicada para a chave

Um INSERT ou UPDATE colocaria um valor que já existe em um índice PRIMARY KEY ou UNIQUE. A mensagem indica o valor e a chave.

Número do erro
1062
Nome
ER_DUP_ENTRY
SQLSTATE
23000
Categoria
Chaves e restrições
Mensagem de erro
Duplicate entry '%s' for key %d

O que significa

O MySQL rejeita uma linha cujo valor em uma chave primária ou índice único coincide com uma linha que já existe. A mensagem mostra o valor duplicado e o índice, por exemplo Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 e posteriores incluem o nome da tabela na chave).

Com um INSERT, as linhas antes do duplicado são mantidas em tabelas não transacionais como MyISAM, mas com InnoDB toda a instrução é revertida.

Causas comuns

  • Reexecutando um script de importação ou seed que insere linhas que já estão presentes.
  • Inserindo um id explícito que já existe, ou um AUTO_INCREMENT contador que foi configurado abaixo do máximo atual.
  • Uma UPDATE que altera uma coluna única para um valor que outra linha possui.
  • Um índice único em uma coluna com um collation que não diferencia maiúsculas de minúsculas: [email protected] e [email protected] contam como o mesmo valor.

Como corrigir

  1. Veja a linha que já contém o valor.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Para atualizar a linha existente, use INSERT ... ON DUPLICATE KEY UPDATE. No MySQL 8.0.19 ou mais recente, referencie os novos valores por um alias de linha; versões mais antigas usam VALUES(name), que ainda funciona, mas está obsoleto.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new
    ON DUPLICATE KEY UPDATE name = new.name;
  3. Para pular duplicatas de propósito, use INSERT IGNORE. Ele transforma o erro em aviso, junto com alguns outros erros, então confira SHOW WARNINGS depois.

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. Se a duplicata estiver em AUTO_INCREMENT, verifique o contador em relação aos dados.

    SELECT MAX(id) FROM users;
    SHOW CREATE TABLE users;  -- shows AUTO_INCREMENT=n

Reproduza com segurança

CREATE TEMPORARY TABLE t (id INT PRIMARY KEY);
INSERT INTO t VALUES (1);
INSERT INTO t VALUES (1);  -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'

Perguntas

Como descubro em qual chave está a duplicata?

A mensagem indica: for key 'PRIMARY' é a chave primária, qualquer outro é o nome de um índice único. SHOW INDEX FROM table_name; lista os índices e suas colunas.

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.