// PostgreSQL-Fehlerreferenz

PostgreSQL 25P03: Zeitüberschreitung bei inaktiver Transaktionssitzung

Die Sitzung saß untätig in einer offenen Transaktion, länger als idle_in_transaction_session_timeout, also hat der Server sie geschlossen.

SQLSTATE
25P03
Name
idle_in_transaction_session_timeout
Kategorie
Ungültiger Transaktionszustand
Fehlermeldung
terminating connection due to idle-in-transaction timeout

Was es bedeutet

Eine Sitzung, die eine Transaktion gestartet hat und dann still wird, ist idle in transaction. Sie hält weiterhin ihre Sperren und verhindert, dass alte Zeilenversionen bereinigt werden. idle_in_transaction_session_timeout lässt den Server solche Sitzungen nach einer Zeitbegrenzung beenden; wenn dies eintritt, erhält der Client diesen FATAL Fehler und die Verbindung wird geschlossen, wodurch die Transaktion zurückgesetzt wird.

Die übliche Ursache ist Anwendungscode, der eine Transaktion öffnet und dann auf etwas anderes wartet, etwa einen Netzwerkaufruf oder eine Benutzereingabe, bevor er committet.

Häufige Ursachen

  • Code, der langsame Arbeiten erledigt (HTTP-Aufrufe, Dateiverarbeitung) zwischen BEGIN und COMMIT.
  • Ein Client oder eine GUI mit ausgeschaltetem Autocommit, offen gelassen nach einer SELECT, sodass eine Transaktion offen bleibt.
  • Ein Ausnahmepfad, der weder committet noch zurückrollt, sodass die gepoolte Verbindung untätig in einer Transaktion liegen bleibt.

Wie du es behebst

  1. Finde Sitzungen, die in einer Transaktion untätig sind, und wie lange sie schon untätig sind.

    SELECT pid, usename, application_name, now() - state_change AS idle_for, query
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
    ORDER BY idle_for DESC;
  2. Erledige langsame Nicht-Datenbank-Arbeiten, bevor du die Transaktion öffnest oder nachdem du sie committet hast, und mach das Commit oder Rollback immer in einer finally Block meldet.

  3. Behalte das Timeout als Sicherheitsnetz; setze es pro Rolle oder Datenbank, wenn einzelne Jobs zu Recht länger brauchen.

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

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.