// Referencia de errores de MySQL

Error de MySQL 1062: entrada duplicada para la clave

Un INSERT o UPDATE intentaría poner un valor que ya existe en una PRIMARY KEY o índice único. El mensaje indica el valor y la clave.

Número de error
1062
Nombre
ER_DUP_ENTRY
SQLSTATE
23000
Categoría
Claves y restricciones
Mensaje de error
Duplicate entry '%s' for key %d

Qué significa

MySQL rechaza una fila cuyo valor en una clave primaria o índice único coincide con una fila que ya existe. El mensaje muestra el valor duplicado y el índice, por ejemplo Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 y posteriores incluyen el nombre de la tabla en la clave).

Con una inserción de varias filas INSERT, las filas anteriores al duplicado se conservan en tablas no transaccionales como MyISAM, pero con InnoDB toda la instrucción se revierte.

Causas comunes

  • Volver a ejecutar un script de importación o de datos iniciales que inserta filas que ya existen.
  • Insertar un id explícito que ya existe, o un AUTO_INCREMENT contador que se configuró por debajo del máximo actual.
  • Una UPDATE que cambia una columna única a un valor que otra fila ya tiene.
  • Un índice único en una columna con una intercalación que no distingue mayúsculas de minúsculas: [email protected] y [email protected] cuentan como el mismo valor.

Cómo solucionarlo

  1. Mira la fila que ya tiene el valor.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Para actualizar la fila existente en su lugar, usa INSERT ... ON DUPLICATE KEY UPDATE. En MySQL 8.0.19 y posteriores, usa un alias de fila para referirte a los valores nuevos; las versiones anteriores usan VALUES(name), que todavía funciona, pero está obsoleto.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new
    ON DUPLICATE KEY UPDATE name = new.name;
  3. Para omitir duplicados a propósito, usa INSERT IGNORE. Convierte ese error en advertencia, junto con algunos otros, así que revisa SHOW WARNINGS después.

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. Si el duplicado está en AUTO_INCREMENT, coteja el contador con los datos.

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

Reprodúcelo de forma segura

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'

Preguntas

¿Cómo encuentro en qué clave está el duplicado?

El mensaje lo indica: for key 'PRIMARY' es la clave primaria; cualquier otra cosa es el nombre de un índice único. SHOW INDEX FROM table_name; enumera los índices y sus columnas.

Errores relacionados

Más errores de claves y restricciones

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.