// PostgreSQL-Fehlerreferenz

PostgreSQL 25P02: aktuelle Transaktion ist abgebrochen

Eine frühere Anweisung in dieser Transaktion ist fehlgeschlagen, daher lehnt PostgreSQL alles Weitere ab, bis du ein ROLLBACK ausführst (oder zu einem Savepoint zurückrollst).

SQLSTATE
25P02
Name
in_failed_sql_transaction
Kategorie
Ungültiger Transaktionszustand
Fehlermeldung
current transaction is aborted, commands ignored until end of transaction block

Was es bedeutet

In PostgreSQL versetzt jeder Fehler innerhalb eines Transaktionsblocks die gesamte Transaktion in einen fehlgeschlagenen Zustand. Von da an schlägt jede Anweisung außer ROLLBACK (oder ROLLBACK TO SAVEPOINT) mit 25P02 fehl, ohne ausgeführt zu werden. COMMIT auf einer fehlgeschlagenen Transaktion führt nicht zum Commit; sie beendet die Transaktion und meldet ROLLBACK.

25P02 ist niemals das eigentliche Problem. Es ist das Echo eines Fehlers, der zuvor in derselben Transaktion aufgetreten ist.

Häufige Ursachen

  • Eine Anweisung ist früher in der Transaktion fehlgeschlagen (ein Constraint-Verstoß, ein Tippfehler, ein falscher Cast) und der Code lief weiter, ohne zurückzurollen.
  • Eine Anwendung fängt eine Ausnahme von einer Abfrage ab und verwendet dieselbe Verbindung weiter, noch innerhalb der fehlgeschlagenen Transaktion.
  • Ein Verbindungspool verteilt eine Verbindung, die ihr vorheriger Benutzer in einer fehlgeschlagenen Transaktion hinterlassen hat.

Wie du es behebst

  1. Suche nach dem ersten Fehler der Transaktion, in deinem Anwendungsprotokoll oder im Serverprotokoll, und behebe den.

  2. Beende die fehlgeschlagene Transaktion mit ROLLBACK, und starte dann neu.

    ROLLBACK;
  3. Wenn manche Anweisungen fehlschlagen dürfen, ohne den Rest der Transaktion zu verlieren, pack jede in einen Savepoint.

    BEGIN;
    INSERT INTO audit_log (msg) VALUES ('start');
    SAVEPOINT try_insert;
    INSERT INTO users (id, email) VALUES (1, '[email protected]');  -- may fail
    -- on error:
    ROLLBACK TO SAVEPOINT try_insert;
    COMMIT;  -- audit_log row is kept
  4. In psql, \set ON_ERROR_ROLLBACK interactive lässt psql vor jeder Anweisung einen impliziten Savepoint setzen, damit ein Tippfehler eine interaktive Transaktion nicht abbricht.

Sicher reproduzieren

BEGIN;
SELECT 1/0;          -- ERROR: division by zero
SELECT 1;            -- ERROR: current transaction is aborted ...
ROLLBACK;

Fragen

Warum sagt COMMIT ROLLBACK?

Die Transaktion war bereits fehlgeschlagen, es gibt also nichts Gültiges zu committen. PostgreSQL beendet sie und meldet ROLLBACK um das klarzustellen.

Zugehörige Fehler

Weitere Fehler bei ungültigem Transaktionszustand

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.