// 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.
  • autocommit 已關閉的用戶端或 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 和你使用的其他資料庫。