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
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
-
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;
-
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';
-
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.
-
Haz que el servidor termine automáticamente las sesiones abandonadas.
ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min'; SELECT pg_reload_conf();
-
Aumentar
max_connectionssolo 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
57P03no se puede conectar ahora25P03tiempo de espera de sesión inactiva en transacción28000especificación de autorización no válida1040MySQL: demasiadas conexionesORA-00018Oracle: número máximo de sesiones excedidoORA-00020Oracle: número máximo de procesos excedido
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.
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.