// PostgreSQL-Fehlerreferenz

PostgreSQL 55P03: Sperre nicht verfügbar

Eine Sperranforderung wartete nicht, sondern gab auf: NOWAIT wurde verwendet oder lock_timeout ist abgelaufen, während eine andere Sitzung eine kollidierende Sperre hielt.

SQLSTATE
55P03
Name
lock_not_available
Kategorie
Objekt befindet sich nicht im erforderlichen Zustand
Fehlermeldung
could not obtain lock on row in relation "orders"

Was es bedeutet

Normalerweise wartet PostgreSQL auf eine Sperre, so lange es braucht. 55P03 bedeutet, dass die Anweisung angewiesen wurde, nicht zu warten: SELECT ... FOR UPDATE NOWAIT oder LOCK TABLE ... NOWAIT sofort fehlschlagen, wenn die Sperre besetzt ist, und wenn lock_timeout gesetzt ist, schlägt jede Anweisung fehl, sobald sie so lange gewartet hat. Ein Sperr-Timeout wird canceling statement due to lock timeout mit demselben Code gemeldet.

Die andere Sitzung, die die Sperre hält, ist nicht betroffen. Innerhalb eines Transaktionsblocks bricht die fehlgeschlagene Anweisung die Transaktion ab.

Häufige Ursachen

  • FOR UPDATE NOWAIT, FOR SHARE NOWAIT oder LOCK TABLE ... NOWAIT ist auf eine Zeile oder Tabelle gestoßen, die eine andere Transaktion gesperrt hat.
  • A lock_timeout abgelaufen, typischerweise bei DDL wie ALTER TABLE, die eine exklusive Sperre benötigt und hinter lang laufenden Abfragen wartet.
  • Eine lange Transaktion oder eine Sitzung, die untätig in einer Transaktion hängt und Sperren hält.

Wie du es behebst

  1. Finde die Sitzung, die die Sperre hält.

    SELECT pid, usename, state, xact_start, query
    FROM pg_stat_activity
    WHERE pid IN (
        SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity
    );
  2. Bei Job-Warteschlangen überspringe gesperrte Zeilen, statt zu scheitern.

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. Bei Schemaänderungen verwende einen kurzen lock_timeout bewusst und versuche es erneut, sodass das ALTER nicht hinter einer langen Abfrage in die Warteschlange gestellt wird und alle anderen blockiert.

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. Beende oder verkürze die blockierende Transaktion; wurde sie verwaist, terminiere sie.

    SELECT pg_terminate_backend(12345);  -- the blocking pid

Sicher reproduzieren

Führe es in zwei Verbindungen aus; beende Sitzung 1 danach mit ROLLBACK.

-- Session 1:
CREATE TABLE q (id int PRIMARY KEY);
INSERT INTO q VALUES (1);
BEGIN; SELECT * FROM q WHERE id = 1 FOR UPDATE;
-- Session 2:
SELECT * FROM q WHERE id = 1 FOR UPDATE NOWAIT;  -- ERROR: could not obtain lock on row in relation "q"

Zugehörige Fehler

Weitere Fehler, wenn ein Objekt nicht im erforderlichen Zustand ist

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.