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
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_INCREMENTcontador que se configuró por debajo del máximo actual. - Una
UPDATEque 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
-
Mira la fila que ya tiene el valor.
SELECT * FROM users WHERE email = '[email protected]';
-
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 usanVALUES(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; -
Para omitir duplicados a propósito, usa
INSERT IGNORE. Convierte ese error en advertencia, junto con algunos otros, así que revisaSHOW WARNINGSdespués.INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
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
1452Error de clave foránea: no se puede añadir la fila hija1048La columna no puede ser nula1586Entrada duplicada para la clave (con nombre de clave)23505PostgreSQL: la clave duplicada infringe la restricción de unicidad2627SQL Server: Infracción de PRIMARY KEY o UNIQUE KEYORA-00001Oracle: restricción de unicidad violadaSQLITE_CONSTRAINT_UNIQUESQLite: falló la restricción UNIQUE
Más errores de claves y restricciones
1061Nombre de clave duplicado1451Error de clave foránea: no se puede eliminar la fila padre1216No se puede añadir o actualizar una fila hija1217No se puede eliminar o actualizar una fila padre1215No se puede añadir la restricción de clave foránea3780Las columnas de clave foránea son incompatibles1822Falta un índice para la restricción de clave foránea1824Error al abrir la tabla referenciada
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.
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.