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
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
BEGINeCOMMIT. - 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
-
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;
-
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
finallybloco. -
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
57P01encerrando a conexão devido ao administrador53300muitas conexões55P03bloqueio não disponível08006falha de conexão
Mais erros de estado de transação inválido
25001não pode ser executado dentro de um bloco de transação25006transação SQL somente leitura25P02a transação atual foi abortada
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.
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.