// Referencia de errores de PostgreSQL

PostgreSQL 53300: demasiadas conexiones

El servidor ha alcanzado max_connections y rechaza nuevas sesiones. Suele deberse a una fuga de conexiones o a pools que en conjunto abren más conexiones de las permitidas.

SQLSTATE
53300
Nombre
too_many_connections
Categoría
Recursos insuficientes
Mensaje de error
sorry, too many clients already

Qué significa

PostgreSQL ejecuta un proceso de servidor por conexión y limita el total con max_connections (100 por defecto). Cuando no queda ningún hueco libre, una nueva conexión falla con 53300 antes de poder iniciar sesión.

Se reservan algunos espacios para superusuarios (superuser_reserved_connections, 3 por defecto) y, en PostgreSQL 16 y posteriores, para roles en pg_use_reserved_connections. Los roles ordinarios ven entonces remaining connection slots are reserved for roles with the SUPERUSER attribute (la redacción varía según la versión) con el mismo código. Un rol o base de datos también puede tener su propio CONNECTION LIMIT, que falla con too many connections for role "app".

Causas comunes

  • Una aplicación filtra conexiones: las abre y nunca las cierra ni las devuelve al pool.
  • Varias instancias de la aplicación, cada una con su propio pool, suman más de max_connections.
  • Muchas sesiones en estado de idle in transaction, ocupando ranuras y bloqueos.
  • Un pico de tráfico o un trabajo que abre una conexión por tarea.

Cómo solucionarlo

  1. Ve quién está conectado y qué está haciendo (conéctate como superusuario, que aún puede entrar).

    SELECT usename, application_name, client_addr, state, count(*)
    FROM pg_stat_activity
    GROUP BY 1, 2, 3, 4
    ORDER BY count(*) DESC;
  2. Finaliza las sesiones que se quedaron inactivas dentro de una transacción o que pertenecen a un cliente descontrolado.

    SELECT pg_terminate_backend(pid)
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
      AND state_change < now() - interval '10 minutes';
  3. Repara la fuga o reduce el tamaño de los pools para que su total se mantenga por debajo del límite, y coloca un pooler como PgBouncer delante de muchos clientes pequeños.

  4. Haz que el servidor termine automáticamente las sesiones abandonadas.

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. Aumentar max_connections solo si el servidor tiene memoria suficiente; hay que reiniciarlo.

    ALTER SYSTEM SET max_connections = 200;  -- takes effect after restart

Preguntas

¿Cuántas conexiones puede manejar PostgreSQL?

max_connections vale 100 por defecto. Cada conexión es un proceso aparte con su propia memoria, así que para cientos de conexiones mayormente inactivas es mejor un pooler de conexiones que un max_connections muy alto.

Errores relacionados

Más errores de recursos insuficientes

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.