MySQL: replication duplicate key stops SQL thread

In breve: MySQL replication duplicate key — indica che la replica si arresta perché una riga già esistente viola un indice univoco.

Cosa indica il problema

MySQL replication duplicate key — indica che la replica si arresta perché una riga già esistente 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: replication duplicate key stops SQL thread” 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

• La replica applica una riga che confligge con dati già presenti
• Schema non allineato alla versione applicativa
• Dato non compatibile con tipo o lunghezza
• Indice oltre i limiti di charset e formato riga

Controlli da eseguire

1. Identifica evento, chiave e divergenza tra source e replica
2. Mostrare definizione della tabella e query coinvolta
3. Identificare valore e riga che causano l’errore
4. Confrontare schema atteso e reale
5. Controllare charset, collation, motore e formato riga

Dati utili

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

Correzione sicura

1. Riallinea i dati con una procedura di replica; non saltare eventi senza valutarli
2. Completare una migrazione schema con backup
3. Normalizzare i dati prima dell’inserimento
4. Ridisegnare indici e tipi secondo i limiti reali
5. Usare strumenti di controllo e riparazione adatti al motore

Verifica finale

• La query termina con il risultato previsto
• Schema e vincoli restano coerenti
• Non compaiono nuovi warning o lock
• L’applicazione legge e scrive i dati correttamente

Errori da evitare

• Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
• Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
• Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
• Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza

Guide Xlogic correlate

• MySQL Error 1061: duplicate key name
• MySQL Error 1169: cannot write duplicate key
• MySQL Error 1022: cannot write duplicate key in table

Fonti tecniche

• MySQL 8.4 Reference Manual
• MariaDB Documentation

Domande frequenti