// PostgreSQL 錯誤參考
PostgreSQL 25P03:交易中閒置的工作階段逾時
工作階段在開啟的交易中閒置、無所作為的時間超過 idle_in_transaction_session_timeout,因此伺服器將其關閉。
- SQLSTATE
25P03- 名稱
idle_in_transaction_session_timeout- 類別
- 無效的交易狀態
它的意義
已開啟交易然後陷入閒置的工作階段是 idle in transaction。它仍持有鎖定,並讓舊的資料列版本一直無法被 vacuum 清掉。 idle_in_transaction_session_timeout 會讓伺服器在超過時限後結束這類工作階段;觸發時,用戶端會收到這個 FATAL 發生錯誤,連線已關閉,交易將回滾。
最常見的根本原因是:應用程式開啟交易後,在提交之前又去等待別的事情,例如網路呼叫或使用者輸入。
常見原因
- 在以下兩者之間執行緩慢工作(HTTP 呼叫、檔案處理)的程式碼:
BEGIN和COMMIT. - autocommit 已關閉的用戶端或 GUI,在某個
SELECT,所以交易保持開啟。 - 某個例外路徑從不認可也不復原,讓連線池中的連線閒置在交易裡。
如何修正
-
尋找在交易中閒置的工作階段,以及它們已閒置多久。
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;
-
在開啟交易之前或提交交易之後執行緩慢的非資料庫工作,並且一律在
finally區塊。 -
把逾時當作安全網;如果某些作業確實需要更久,可依角色或資料庫另行設定。
ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';
相關錯誤
更多無效的交易狀態錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。