// Referência de erro do PostgreSQL

PostgreSQL 08006: falha na conexão

A conexão com o servidor caiu durante o uso. O processo do servidor terminou, reiniciou ou foi morto, ou a rede derrubou uma conexão ociosa.

SQLSTATE
08006
Nome
connection_failure
Categoria
Exceção de conexão
Mensagem de erro
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

O que significa

08006 é um código do lado do cliente: os drivers o relatam quando uma conexão estabelecida falha no meio de uma conversa. O servidor não pode enviar um erro por uma conexão que não funciona mais, então a mensagem vem da biblioteca do cliente. Ferramentas baseadas em libpq (psql, psycopg) exibem a mensagem acima, e o PgJDBC relata SQLSTATE 08006 com An I/O error occurred while sending to the backend.

O log do servidor geralmente explica o motivo: uma falha e reinício do backend, uma finalização por falta de memória, um administrador encerrando a sessão, ou nada quando um firewall ou balanceador de carga derrubou silenciosamente uma conexão TCP ociosa.

Causas comuns

  • O processo do servidor da sessão caiu ou foi morto, geralmente pelo OOM killer do sistema operacional, o que faz o PostgreSQL reiniciar todas as sessões.
  • O servidor foi reiniciado ou passou por um failover.
  • Um firewall, gateway NAT ou balanceador de carga na nuvem descartou uma conexão que ficou ociosa por mais tempo do que o seu tempo limite.
  • A sessão foi encerrada por pg_terminate_backend() ou por um tempo limite de inatividade, e o cliente só percebeu na próxima consulta.

Como corrigir

  1. Verifique o log do servidor próximo ao momento da falha para terminated by signal, server process ... was terminated, ou uma reinicialização.

  2. Se uma conexão ociosa foi descartada pela rede, habilite keepalives TCP no servidor (ou no cliente) para que a conexão nunca pareça ociosa.

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. Configure o pool de conexões para validar ou reciclar conexões antes de entregá-las, e repetir a operação uma vez em uma conexão nova quando for seguro fazê-lo.

  4. Se o servidor ficou sem memória, encontre a consulta que a utilizou e reduza work_mem ou o número de conexões simultâneas.

Erros relacionados

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.