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
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
BEGINundCOMMIT. - 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
-
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;
-
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
finallyBlock meldet. -
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
57P01Verbindung wird durch den Administrator beendet53300zu viele Verbindungen55P03Sperre nicht verfügbar08006Verbindungsfehler
Weitere Fehler bei ungültigem Transaktionszustand
25001Kann nicht innerhalb eines Transaktionsblocks ausgeführt werden25006Schreibgeschützte SQL-Transaktion25P02Die aktuelle Transaktion wurde abgebrochen
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.
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.