// Referência de erro do PostgreSQL

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
Mensagem de erro
sorry, too many clients already

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

  1. 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;
  2. 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';
  3. 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.

  4. Configure o servidor para encerrar automaticamente as sessões abandonadas.

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. Aumente max_connections apenas 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

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.

// 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.