MySQL error 1062: Duplicate entry for key

In breve: MySQL error 1062 — indica che un inserimento viola un indice univoco.

Cosa indica il problema

MySQL error 1062 — indica che un inserimento viola un indice univoco. La diagnosi deve collegare la prova, l’orario e il primo evento utile nei log prima di cambiare la configurazione.

Sintomi e cause probabili

Sintomi da verificare

• Il comportamento descritto da “MySQL error 1062: Duplicate entry for key” si ripete nella stessa operazione
• Il controllo di query, schema e log del database produce un dato coerente con lo stesso orario
• Un tentativo comparabile permette di capire se l’anomalia è generale o limitata a un solo elemento

Cause probabili

• Importazione tenta di inserire una chiave univoca già presente
• Retry di una richiesta ripete la stessa operazione non idempotente
• AUTO_INCREMENT o identificatore applicativo non è allineato ai dati
• Due processi concorrenti creano lo stesso valore unico

Controlli da eseguire

1. Leggi nome dell’indice e valore duplicato nell’errore 1062
2. Cerca entrambe le righe candidate su una copia
3. Controlla origine dell’importazione o del retry
4. Verifica AUTO_INCREMENT e logica che genera l’identificatore
5. Riproduci la concorrenza con dati di prova

Dati utili

• Log MySQL o MariaDB
• PhpMyAdmin o client SQL
• Error_log dell’applicazione chiamante

Correzione sicura

1. Rendi idempotente l’inserimento o il retry
2. Correggi il dato duplicato rispettando la regola applicativa
3. Riallinea AUTO_INCREMENT solo dopo aver verificato il valore massimo
4. Usa transazione o upsert quando il flusso lo richiede
5. Non eliminare una riga esistente senza verificarne relazioni e contenuto

Verifica finale

• Il test relativo a Duplicate entry for key termina con il risultato previsto
• Nei log successivi a Duplicate entry for key non ricompare lo stesso errore
• Le funzioni collegate a Duplicate entry for key restano operative
• La correzione relativa a Duplicate entry for key resta valida in due prove consecutive

Errori da evitare

• Non modificare più componenti durante la diagnosi di Duplicate entry for key
• Non cancellare dati per nascondere la situazione Duplicate entry for key
• Non disattivare globalmente le protezioni per aggirare Duplicate entry for key
• Non condividere credenziali o dati personali nei test di Duplicate entry for key

Guide Xlogic correlate

• MySQL Error 1061: duplicate key name
• MySQL error 1264: Out of range value for column
• MySQL error 1213 in WordPress: Deadlock found

Fonti tecniche

• MySQL 8.4 Reference Manual
• MariaDB Documentation

Domande frequenti