57P01: admin_shutdown

O que significa?

Sua conexão ativa foi encerrada por causa de um comando de administrador. O cliente recebe este erro quando o servidor está sendo desligado ou a sessão é encerrada manualmente ('terminating connection due to administrator command').

Por que acontece?

Um DBA encerrou a sessão com pg_terminate_backend(); o servidor está sendo desligado em modo fast/immediate (o smart shutdown não encerra sessões, ele espera que terminem); ou as conexões existentes foram derrubadas por uma mudança de configuração/manutenção planejada. Em alguns cenários de failover, o antigo primário também corta as conexões dessa forma.

Como resolver

Geralmente não é um erro permanente; a aplicação deve se reconectar (retry). Se for inesperado, investigue no log do servidor o motivo do shutdown/encerramento. Para manutenções planejadas, implemente reconexão automática e health checks do pool de conexões na aplicação. O log do servidor não mostra quem encerrou uma sessão; para rastrear chamadas de pg_terminate_backend, mantenha uma trilha de auditoria com log_statement (ou pgaudit).