PostgreSQL 25P03: тайм-аут сеанса, простаивающего в транзакции
Сеанс бездействовал в открытой транзакции дольше, чем idle_in_transaction_session_timeout, поэтому сервер его закрыл.
- SQLSTATE
25P03- Имя
idle_in_transaction_session_timeout- Категория
- Недопустимое состояние транзакции
Что это значит
Сессия, которая начала транзакцию, а затем замолкает, — это idle in transaction. Она по-прежнему держит блокировки и мешает вакуумной очистке удалять старые версии строк. idle_in_transaction_session_timeout заставляет сервер завершать такие сеансы по истечении лимита времени; когда лимит срабатывает, клиент получает такое сообщение FATAL ошибку, и соединение закрывается, откатывая транзакцию.
Обычной причиной является код приложения, который открывает транзакцию и затем ждёт чего-то другого, например сетевого вызова или ввода пользователя, перед коммитом.
Распространённые причины
- Код, который выполняет медленные операции (HTTP-запросы, обработку файлов) между
BEGINиCOMMIT. - Клиент или графический интерфейс с выключенным автокоммитом, оставшийся открытым после
SELECT, так что транзакция остаётся открытой. - Путь исключения, который никогда не фиксирует и не откатывает транзакцию, оставляя соединение из пула в состоянии «idle in transaction».
Как исправить
-
Найдите сеансы, бездействующие в транзакции, и как долго они бездействуют.
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';
Связанные ошибки
57P01прерывание соединения администратором53300слишком много подключений55P03блокировка недоступна08006сбой подключения
Больше ошибок недопустимого состояния транзакции
25001невозможно выполнить внутри блока транзакции25006SQL-транзакция только для чтения25P02текущая транзакция прервана
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.