// справочник ошибок 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. Она по-прежнему держит блокировки и мешает вакуумной очистке удалять старые версии строк. idle_in_transaction_session_timeout заставляет сервер завершать такие сеансы по истечении лимита времени; когда лимит срабатывает, клиент получает такое сообщение FATAL ошибку, и соединение закрывается, откатывая транзакцию.

Обычной причиной является код приложения, который открывает транзакцию и затем ждёт чего-то другого, например сетевого вызова или ввода пользователя, перед коммитом.

Распространённые причины

  • Код, который выполняет медленные операции (HTTP-запросы, обработку файлов) между BEGIN и COMMIT.
  • Клиент или графический интерфейс с выключенным автокоммитом, оставшийся открытым после SELECT, так что транзакция остаётся открытой.
  • Путь исключения, который никогда не фиксирует и не откатывает транзакцию, оставляя соединение из пула в состоянии «idle in transaction».

Как исправить

  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 или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.