// PostgreSQL-Fehlerreferenz

PostgreSQL 40P01: Deadlock erkannt

Zwei oder mehr Transaktionen warteten auf die Sperren der jeweils anderen. PostgreSQL hat eine zurückgesetzt, damit die andere abschließen konnte; wiederhole die fehlgeschlagene.

SQLSTATE
40P01
Name
deadlock_detected
Kategorie
Transaktions-Rollback
Fehlermeldung
deadlock detected
DETAIL:  Process 1234 waits for ShareLock on transaction 5678; blocked by process 4321.
Process 4321 waits for ShareLock on transaction 8765; blocked by process 1234.

Was es bedeutet

Ein Deadlock ist ein Zyklus von Sperrwarten: Transaktion A hält eine Sperre, die B braucht, während sie auf eine Sperre von B wartet. Keine der beiden kann je weitermachen, also wenn eine Sperrwarte länger andauert als deadlock_timeout (standardmäßig 1 Sekunde) auf einen Zyklus und bricht, falls ein solcher gefunden wird, eine der Transaktionen mit 40P01 ab.

Die abgebrochene Transaktion wird vollständig zurückgesetzt. Die andere läuft weiter. Die DETAIL Zeilen zeigen, welche Prozesse beteiligt waren, und die CONTEXT Zeile, welche Anweisung wartete.

Häufige Ursachen

  • Zwei Transaktionen aktualisieren dieselben Zeilen in unterschiedlicher Reihenfolge, zum Beispiel überweist eine Geld von Konto 1 auf 2, während eine andere von 2 auf 1 geht.
  • Fremdschlüssel: Das Einfügen untergeordneter Zeilen nimmt eine FOR KEY SHARE Sperre auf der übergeordneten Zeile, die mit einer anderen Transaktion, die dieses übergeordnete Element aktualisiert, in Konflikt geraten kann.
  • Lange Transaktionen, die viele Zeilen berühren, wodurch das Zeitfenster für eine überlappende Sperrreihenfolge vergrößert wird.
  • Explizit LOCK TABLE oder SELECT ... FOR UPDATE in unterschiedlichen Reihenfolgen in verschiedenen Codepfaden genommen.

Wie du es behebst

  1. Versuche, die fehlgeschlagene Transaktion erneut auszuführen. Ein Deadlock ist ein normales Ergebnis von Nebenläufigkeit, und die Anwendung sollte SQLSTATE 40P01 (und 40001) und die gesamte Transaktion noch einmal ausführen.

  2. Nimm Sperren überall in einer konsistenten Reihenfolge, zum Beispiel immer zuerst die Sperre für die niedrigere ID.

    BEGIN;
    SELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    UPDATE accounts SET balance = balance + 100 WHERE id = 2;
    COMMIT;
  3. Halte Transaktionen kurz: erst die Lesevorgänge und Berechnungen, dann die Schreibvorgänge, und committe zügig.

  4. Einschalten log_lock_waits sodass Wartezeiten länger als deadlock_timeout werden mit den beteiligten Anweisungen protokolliert, sieh dir dann das Serverprotokoll an.

    ALTER SYSTEM SET log_lock_waits = on;
    SELECT pg_reload_conf();

Sicher reproduzieren

Führe die Schritte in zwei separaten Verbindungen der Reihe nach auf einer Testdatenbank aus.

-- Session 1:
CREATE TABLE dl (id int PRIMARY KEY, v int);
INSERT INTO dl VALUES (1, 0), (2, 0);
BEGIN; UPDATE dl SET v = 1 WHERE id = 1;
-- Session 2:
BEGIN; UPDATE dl SET v = 2 WHERE id = 2;
UPDATE dl SET v = 2 WHERE id = 1;   -- waits
-- Session 1:
UPDATE dl SET v = 1 WHERE id = 2;   -- one session gets ERROR: deadlock detected

Fragen

Welche Transaktion bricht PostgreSQL bei einer Deadlock-Situation ab?

Diejenige, deren Deadlock-Prüfung den Zyklus gefunden hat, was sich im Allgemeinen nicht vorhersagen lässt. Schreibe jede Transaktion so, dass sich ein erneuter Versuch starten lässt.

Zugehörige Fehler

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL 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 PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.