PostgreSQL sem conexões disponíveis: diagnóstico e connection pooling com PgBouncer
Publicado em 2026-11-14 por frfrand
Identifique o esgotamento de conexões no PostgreSQL, investigue o pg_stat_activity e decida quando configurar pooling e PgBouncer.

Sua aplicação começa a responder com erros de conexão ao PostgreSQL exatamente quando as visitas crescem. Aumentar max_connections parece uma solução imediata, mas pode agravar a pressão de memória. Antes de fazer isso, identifique quem abre conexões, quanto tempo duram e se realmente trabalham.
1. Verifique o problema
Consulte o limite e a atividade com uma conta autorizada:
SHOW max_connections;
SHOW superuser_reserved_connections;
SELECT state, count(*) AS conexiones
FROM pg_stat_activity
GROUP BY state
ORDER BY conexiones DESC;
Revise erros da aplicação, número de instâncias, processos, conexões por worker e histórico de picos. Nem todas as conexões visíveis são consultas simultaneamente ativas: pode haver sessões idle que ocupam recursos sem fazer trabalho.
2. Encontre conexões bloqueadas ou abandonadas
Uma consulta básica de observação:
SELECT pid, usename, application_name, state,
now() - state_change AS tiempo_en_estado,
wait_event_type
FROM pg_stat_activity
WHERE backend_type = 'client backend'
ORDER BY tiempo_en_estado DESC
LIMIT 30;
Evite terminar processos sem investigar: você poderia interromper transações legítimas. Revise idle in transaction porque mantém transações abertas que podem afetar bloqueios e manutenção.
3. Calcule conexões máximas da sua arquitetura
Uma regra orientativa é:
conexiones potenciales = instancias de API × pool por instancia
+ workers × pool de cada worker
+ tareas administrativas
Não confunda o tamanho máximo do pool com seu uso constante. Se você escala de duas a dez instâncias e cada uma abre 20 conexões, o teto potencial salta de 40 para 200 antes de contar outros serviços.
4. O que faz o PgBouncer
O PgBouncer recebe conexões de clientes e reutiliza conexões de servidor. No modo transaction pooling, ele empresta uma conexão do PostgreSQL por transação, o que permite muitos clientes lógicos com menos backends físicos. No entanto, funções que dependem de estado de sessão, tabelas temporais, prepared statements ou outros comportamentos podem exigir configuração ou alterações. Consulte a compatibilidade do seu driver e versão.
Não ative o transaction pooling às cegas: teste migrações, transações explícitas, sessões e tarefas de longa duração. Para alguns casos, convém o session pooling ou um pool dentro da própria aplicação.
5. Não esconda consultas lentas atrás de um pool
Se todas as conexões executarem consultas custosas, o PgBouncer apenas enfileira mais trabalho. Revise o tempo de consultas, índices, bloqueios e p95; adicione limites de espera e métricas de saturação. Um pool deve controlar concorrência e estabilidade, não substituir a otimização de SQL.
6. Plano seguro
1. Meça conexões e estados em horários de pico. 2. Corrija vazamentos, transações abertas e pools mal dimensionados. 3. Teste o PgBouncer com tráfego representativo. 4. Implante gradualmente com alertas e possibilidade de reversão.
Complementa com EXPLAIN ANALYZE para PostgreSQL, túnel SSH para PostgreSQL y PostgreSQL en ArduMaker.
Perguntas frequentes
### É suficiente aumentar max_connections? Não se a causa for um vazamento, escalonamento descontrolado ou consultas bloqueadas.
O PgBouncer torna as consultas mais rápidas?
Não diretamente: reduz a pressão de conexões e pode melhorar a estabilidade.
Preciso de pooling se tenho poucos usuários?
Depende do número de processos, tamanho do pool e padrão de uso.
Referências: pg_stat_activity, PgBouncer.