PostgreSQL 53300 en base de datos: se alcanzó el límite de conexiones

Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.

1. 1

   Quién ocupa las conexiones

   Requiere herramientas

   Quién:

   el DBA o administrador.

   Cómo:

   desde una ranura reservada, consulta pg_stat_activity agrupando por usename, application_name y state, con backend_start y xact_start.

   Resultado que importa:

   qué aplicación concentra sesiones y en qué estado.

   Si predominan sesiones idle de una aplicación:

   apunta a conexiones que no se devuelven.

   Si predominan sesiones active:

   indica carga real; revisa consultas lentas antes de tocar el límite.

   Evidencia a conservar:

   resultado agrupado con hora.

   Solo el DBA, usando la ranura reservada. Si no tienes ese acceso, no lo intentes con otras cuentas.

   Evidencia: PostgreSQL connection settings · PostgreSQL 18 cumulative statistics system

2. 2

   Límite frente a lo que piden las aplicaciones

   Sin herramientas especiales

   Quién:

   el equipo de plataforma.

   Cómo:

   suma el máximo de conexiones que puede abrir cada instancia y compáralo con max_connections menos las ranuras reservadas.

   Resultado que importa:

   si la demanda posible supera las ranuras disponibles.

   Si la supera:

   confirma un dimensionado incorrecto; reduce las conexiones por instancia antes de subir el límite.

   Si no la supera:

   descarta el dimensionado y vuelve a las sesiones que no se cierran.

   Evidencia a conservar:

   tabla con instancias, máximos y total.

   Evidencia: PostgreSQL connection settings

3. 3

   Lo que puede hacer quien usa la aplicación

   Sin herramientas especiales

   Quién:

   quien usa la aplicación.

   Cómo:

   si la aplicación muestra este código, espera unos minutos y vuelve a intentarlo una sola vez; si persiste, avisa al soporte con la hora.

   Resultado que importa:

   si el servicio vuelve.

   Si vuelve:

   indica un pico puntual de conexiones.

   Si persiste:

   confirma un problema del servidor que debe resolver el operador.

   Evidencia a conservar:

   hora de cada intento.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes

Un código solo tiene significado dentro del producto y la versión correctos.

El apéndice A asigna 53300 a too_many_connections, en la clase 53 (recursos insuficientes). max_connections fija cuántas conexiones simultáneas admite el servidor, por defecto 100, y solo cambia al reiniciar. Se reservan ranuras para superusuarios (3 por defecto) y para roles con pg_use_reserved_connections. Subir el límite aumenta la memoria compartida reservada. El código indica que no quedan ranuras, no qué aplicación las ocupa.

• Atención altaadvertencia editorial

  Detente antes de subir max_connections sin más: exige reiniciar el servidor y reserva más memoria. Corrige primero las conexiones que no se cierran.

  Evidencia: PostgreSQL connection settings

• Precauciónadvertencia editorial

  Terminar sesiones aborta lo que estuvieran haciendo. No lo hagas sin saber qué aplicación las usa.

  Evidencia: PostgreSQL 18 system administration functions

1. 1

   PostgreSQL 18 Appendix A: Error Codes

   PostgreSQL Global Development Group · 2026 · official_doc

2. 2

   PostgreSQL connection settings

   PostgreSQL Global Development Group · 2026 · official_doc