// PostgreSQL エラーリファレンス

PostgreSQL 25P03: トランザクション内アイドル状態のセッションのタイムアウト

セッションが、idle_in_transaction_session_timeout を超える時間、何もせずオープンなトランザクション内で待機していたため、サーバーが閉じました。

SQLSTATE
25P03
名前
idle_in_transaction_session_timeout
カテゴリ
無効なトランザクション状態
エラーメッセージ
terminating connection due to idle-in-transaction timeout

意味

トランザクションを開始した後、アイドル状態になったセッションは idle in transaction。それでもロックを保持し続け、古い行バージョンが VACUUM で回収されるのを妨げます。 idle_in_transaction_session_timeout サーバーは、制限時間が経過するとそのようなセッションを終了します。それが発動すると、クライアントには次のエラーが返されます FATAL エラーとなり、接続が閉じられ、トランザクションはロールバックされます。

よくある根本原因は、アプリケーションコードがトランザクションを開いた後、ネットワーク呼び出しやユーザー入力など別の何かを待ってからコミットすることです。

よくある原因

  • 時間のかかる処理(HTTP 呼び出し、ファイル処理)を行うコードを、次の間に BEGIN そして COMMIT.
  • 自動コミットをオフにしたクライアントまたは GUI が、次の後も開いたままにしている SELECT、そのため、トランザクションが開いたままになります。
  • コミットもロールバックもしない例外パス。プールされた接続がトランザクション内でアイドル状態のまま残ります。

修正方法

  1. トランザクション内でアイドル状態のセッションと、そのアイドル時間を調べます。

    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. 時間のかかるデータベース以外の処理は、トランザクションを開く前かコミット後に行い、コミットまたはロールバックは必ず finally ブロック。

  3. タイムアウトはセーフティネットとして残し、正当な理由で長い時間が必要なジョブがある場合は、ロールまたはデータベースごとに設定してください。

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

関連エラー

その他の無効なトランザクション状態のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。