// MySQL-Fehlerreferenz

MySQL-Fehler 1062: Doppelter Eintrag für Schlüssel

Ein INSERT oder UPDATE würde einen Wert einfügen, der bereits in einem PRIMARY KEY oder UNIQUE-Index existiert. Die Meldung nennt den Wert und den Schlüssel.

Fehlernummer
1062
Name
ER_DUP_ENTRY
SQLSTATE
23000
Kategorie
Schlüssel und Constraints
Fehlermeldung
Duplicate entry '%s' for key %d

Was es bedeutet

MySQL lehnt eine Zeile ab, deren Wert in einem Primärschlüssel oder eindeutigen Index mit einer bereits existierenden Zeile übereinstimmt. Die Meldung zeigt den doppelten Wert und den Index, zum Beispiel Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 und höher nehmen den Tabellennamen in den Schlüssel auf).

Bei einer Mehrzeilen- INSERTwerden die Zeilen vor dem Duplikat in nicht-transaktionalen Tabellen wie MyISAM beibehalten, aber bei InnoDB wird die gesamte Anweisung zurückgesetzt.

Häufige Ursachen

  • Erneutes Ausführen eines Import- oder Seed-Skripts, das Zeilen einfügt, die schon vorhanden sind.
  • Einfügen einer expliziten ID, die bereits existiert, oder ein AUTO_INCREMENT Zähler, der unter dem aktuellen Maximum gesetzt wurde.
  • Eine UPDATE , der eine eindeutige Spalte in einen Wert ändert, den eine andere Zeile hat.
  • Ein eindeutiger Index auf einer Spalte mit einer Kollation, die Groß- und Kleinschreibung nicht unterscheidet: [email protected] und [email protected] wird als derselbe Wert gezählt.

Wie du es behebst

  1. Sieh dir die Zeile an, die den Wert bereits enthält.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Um stattdessen die vorhandene Zeile zu aktualisieren, verwende INSERT ... ON DUPLICATE KEY UPDATE. In MySQL 8.0.19 und höher greifst du über einen Zeilen-Alias auf die neuen Werte zu; ältere Versionen verwenden VALUES(name), was immer noch funktioniert, aber veraltet ist.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new
    ON DUPLICATE KEY UPDATE name = new.name;
  3. Um Duplikate absichtlich zu überspringen, verwende INSERT IGNORE. Es macht aus dem Fehler eine Warnung, zusammen mit einigen anderen Fehlern, prüfe also SHOW WARNINGS danach.

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. Wenn das Duplikat auf AUTO_INCREMENT, gleiche den Zähler mit den Daten ab.

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

Sicher reproduzieren

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'

Fragen

Wie finde ich heraus, auf welchem Schlüssel das Duplikat liegt?

Die Meldung nennt ihn: for key 'PRIMARY' ist der Primärschlüssel, alles andere ist der Name eines eindeutigen Index. SHOW INDEX FROM table_name; listet die Indizes und ihre Spalten auf.

Zugehörige Fehler

Weitere Fehler bei Schlüsseln und Constraints

Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit MySQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für MySQL und die anderen Datenbanken, mit denen du arbeitest.