// Référence des erreurs MySQL

Erreur MySQL 1062 : Entrée en double pour la clé

Un INSERT ou UPDATE insérerait une valeur déjà existante dans un index PRIMARY KEY ou UNIQUE. Le message indique la valeur et la clé.

Numéro d'erreur
1062
Nom
ER_DUP_ENTRY
SQLSTATE
23000
Catégorie
Clés et contraintes
Message d'erreur
Duplicate entry '%s' for key %d

Ce que cela signifie

MySQL rejette une ligne dont la valeur dans une clé primaire ou un index unique correspond à une ligne déjà existante. Le message affiche la valeur en double et l'index, par exemple Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 et versions ultérieures incluent le nom de la table dans la clé).

Avec une insertion multi-lignes INSERT, les lignes avant le doublon sont conservées sur des tables non transactionnelles comme MyISAM, mais avec InnoDB, l'ensemble de l'instruction est annulé.

Causes courantes

  • Réexécution d'un script d'import ou d'initialisation qui insère des lignes déjà présentes.
  • Insertion d'un identifiant explicite qui existe déjà, ou d'un AUTO_INCREMENT compteur qui a été réglé en dessous du maximum actuel.
  • Une UPDATE qui met une colonne unique à une valeur qu'une autre ligne possède.
  • Un index unique sur une colonne avec une collation insensible à la casse : [email protected] et [email protected] comptent comme une même valeur.

Comment le corriger

  1. Regardez la ligne qui contient déjà la valeur.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Pour mettre plutôt à jour la ligne existante, utilisez INSERT ... ON DUPLICATE KEY UPDATE. Sur MySQL 8.0.19 et les versions ultérieures, faites référence aux nouvelles valeurs via un alias de ligne ; les versions plus anciennes utilisent VALUES(name), qui fonctionne toujours mais est obsolète.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new
    ON DUPLICATE KEY UPDATE name = new.name;
  3. Pour ignorer intentionnellement les doublons, utilisez INSERT IGNORE. Cela transforme l'erreur en avertissement, ainsi que certaines autres erreurs, donc vérifiez SHOW WARNINGS ensuite.

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. Si le doublon concerne AUTO_INCREMENT, vérifiez le compteur par rapport aux données.

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

Reproduisez-le en toute sécurité

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'

Questions

Comment puis-je savoir sur quelle clé se trouve le doublon ?

Le message le nomme : for key 'PRIMARY' est la clé primaire, tout le reste est le nom d'un index unique. SHOW INDEX FROM table_name; liste les index et leurs colonnes.

Erreurs liées

Plus d'erreurs de clés et de contraintes

Le code et le texte du message sont issus de Référence des messages d'erreur MySQL 8.4. Parcourir la liste complète Liste des erreurs MySQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur MySQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour MySQL et les autres bases de données que vous utilisez.