// Referência de erro do PostgreSQL

PostgreSQL 25P03: tempo limite de sessão ociosa em transação

A sessão ficou dentro de uma transação aberta sem fazer nada por mais tempo que idle_in_transaction_session_timeout, então o servidor a encerrou.

SQLSTATE
25P03
Nome
idle_in_transaction_session_timeout
Categoria
Estado de transação inválido
Mensagem de erro
terminating connection due to idle-in-transaction timeout

O que significa

Uma sessão que iniciou uma transação e então fica inativa é idle in transaction. Ele ainda segura os bloqueios dele e impede que versões antigas de linhas sejam limpas pelo vacuum. idle_in_transaction_session_timeout faz com que o servidor encerre tais sessões após um limite de tempo; quando isso ocorre, o cliente recebe este FATAL erro e a conexão é fechada, revertendo a transação.

A causa raiz habitual é um código do aplicativo que abre uma transação e depois fica esperando outra coisa, como uma chamada de rede ou uma entrada do usuário, antes de fazer o commit.

Causas comuns

  • Código que realiza trabalhos lentos (chamadas HTTP, processamento de arquivos) entre BEGIN e COMMIT.
  • Um cliente ou GUI com autocommit desativado, deixado aberto após um SELECT, então uma transação permanece aberta.
  • Um caminho de exceção que nunca realiza commit ou rollback, deixando a conexão do pool ociosa em uma transação.

Como corrigir

  1. Encontre sessões ociosas em uma transação e há quanto tempo elas estão ociosas.

    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. Faça trabalhos lentos que não envolvem banco de dados antes de abrir a transação ou depois de fazer o commit dela, e sempre faça commit ou rollback em um finally bloco.

  3. Mantenha o tempo limite como rede de segurança; defina-o por função ou banco de dados se alguns jobs de fato precisarem de mais tempo.

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

Erros relacionados

Mais erros de estado de transação inválido

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.