PostgreSQL 53300: muitas conexões
O servidor atingiu max_connections e recusa novas sessões. Normalmente é um vazamento de conexão ou pools que, juntos, abrem mais conexões do que o permitido.
- SQLSTATE
53300- Nome
too_many_connections- Categoria
- Recursos insuficientes
O que significa
O PostgreSQL executa um processo de servidor por conexão e limita o total com max_connections (100 por padrão). Quando todos os slots estão ocupados, uma nova conexão falha com 53300 antes de conseguir fazer login.
Alguns slots são reservados para superusuários (superuser_reserved_connections, 3 por padrão) e, no PostgreSQL 16 ou mais recente, para roles em pg_use_reserved_connections. Os papéis comuns então veem remaining connection slots are reserved for roles with the SUPERUSER attribute (a redação varia por versão) com o mesmo código. Uma função ou banco de dados também pode ter seu próprio CONNECTION LIMIT, que falha com too many connections for role "app".
Causas comuns
- Um aplicativo vaza conexões: ele as abre e nunca as fecha ou devolve ao pool.
- Várias instâncias do aplicativo, cada uma com seu próprio pool, somam mais de
max_connections. - Muitas sessões paradas
idle in transaction, segurando slots e bloqueios. - Um pico de tráfego, ou um trabalho que abre uma conexão por tarefa.
Como corrigir
-
Veja quem está conectado e o que está fazendo (conecte-se como superusuário, que ainda consegue entrar).
SELECT usename, application_name, client_addr, state, count(*) FROM pg_stat_activity GROUP BY 1, 2, 3, 4 ORDER BY count(*) DESC;
-
Encerre sessões que estão paradas inativas em uma transação ou que pertencem a um cliente fora de controle.
SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle in transaction' AND state_change < now() - interval '10 minutes';
-
Corrija o vazamento ou reduza o tamanho dos pools para que o total fique abaixo do limite, e coloque um pooler como o PgBouncer na frente de muitos clientes pequenos.
-
Configure o servidor para encerrar automaticamente as sessões abandonadas.
ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min'; SELECT pg_reload_conf();
-
Aumente
max_connectionsapenas se o servidor tiver memória suficiente; é preciso reiniciá-lo.ALTER SYSTEM SET max_connections = 200; -- takes effect after restart
Perguntas
Quantas conexões o PostgreSQL suporta?
O max_connections padrão é 100. Cada conexão é um processo separado com sua própria memória, então centenas de conexões principalmente ociosas são melhor atendidas por um pooler de conexões do que por um max_connections muito alto.
Erros relacionados
57P03não é possível conectar agora25P03tempo limite de sessão ociosa em transação28000especificação de autorização inválida1040MySQL: muitas conexõesORA-00018Oracle: número máximo de sessões excedidoORA-00020Oracle: número máximo de processos excedido
Mais erros de recursos insuficientes
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.