Tutoriales de VPS
MySQL 1040 en un VPS: conexiones, pools y max_connections (2026)
Recupera la administración, localiza conexiones y calcula todos los pools antes de ajustar límites según memoria y carga reales.

Si el sitio muestra ERROR 1040 (HY000): Too many connections, las API no llegan a MySQL y tampoco conectan las herramientas de administración, pueden haberse agotado las conexiones de clientes normales. No implica necesariamente un VPS insuficiente: más procesos, pools multiplicados, conexiones sin devolver y consultas lentas pueden provocar el mismo fallo.
La referencia principal es MySQL 8.4. Recupera la administración, identifica quién ocupa las conexiones y ajusta pools y capacidad. Para MySQL 8.0 consulta su documentación. MariaDB difiere en privilegios, tablas y configuración persistente; no copies sin revisar las sentencias específicas de MySQL.
| Error o síntoma | Qué investigar |
|---|---|
MySQL 1040 Too many connections | Conexiones ordinarias del servidor agotadas |
Too many user connections o límites de recursos de cuenta | Límite por cuenta; no necesariamente max_connections global |
Access denied o 1045 | Cuenta, contraseña y autenticación |
2003, Connection refused o timeout | Servicio, dirección, escucha y red |
Errores de aplicación como QueuePool limit ... timeout | Espera del pool; el servidor puede tener conexiones disponibles |
No aumentes max_connections solo porque la aplicación no conecta. Para red y acceso, consulta la guía MySQL/MariaDB; para 1040, la documentación de Too many connections.
Pausa importaciones, informes, consumidores de colas o instancias problemáticas que puedas identificar como no esenciales. Limita los reintentos y aplica espera progresiva: reintentar inmediatamente cada petición puede crear una tormenta de conexiones.
Conserva la sesión administrativa abierta y evita abrir muchas más. Conecta localmente con una cuenta existente e introduce la contraseña cuando se solicite:
mysql --connect-timeout=5 -u db_admin -p
Sustituye la cuenta de ejemplo db_admin y usa el socket, host y método correctos. sudo mysql no garantiza acceso sin contraseña en todas las instalaciones. En un proyecto Compose existente:
docker compose exec mysql mysql --connect-timeout=5 -u root -p
Sustituye mysql por el servicio real. Ejecutar el cliente dentro del contenedor evita confundir la red con el límite, pero no lo elude.
MySQL suele reservar una conexión adicional para cuentas con CONNECTION_ADMIN. Es un único espacio compartido, no uno por administrador. Si ya está ocupado, otra ventana puede fallar. Prepara privilegios restringidos e interfaces administrativas con antelación; no los concedas a la aplicación para saltarse límites ni abras 3306 al público.
Si no recuperas acceso, reduce tráfico o procesos de aplicación confirmados para que liberen conexiones. Solo considera reiniciar MySQL tras evaluar impacto, conservar pruebas y planificar la recuperación: corta todas las conexiones, pierde información y puede provocar reconexiones simultáneas que repitan el fallo.
Confirma primero la instancia:
SELECT VERSION(), @@hostname, @@port, CURRENT_USER(), CONNECTION_ID();
SHOW GLOBAL VARIABLES
WHERE Variable_name IN (
'max_connections', 'max_user_connections',
'wait_timeout', 'interactive_timeout'
);
SHOW GLOBAL STATUS
WHERE Variable_name IN (
'Threads_connected', 'Threads_running',
'Max_used_connections', 'Connection_errors_max_connections',
'Connections', 'Uptime'
);
Toma muestras desde la misma sesión administrativa:
Threads_connected: conexiones abiertas ahora.Threads_running: hilos no dormidos, no porcentaje de CPU.Max_used_connections: máximo histórico, no conexiones actuales.Connection_errors_max_connections: rechazos al alcanzar el límite; observa su incremento durante el intervalo.Connections: intentos acumulados; usa diferencias de tiempo para calcular tasas.
Registra hora y Uptime, porque reinicios y resets cambian la referencia. Una muestra normal después del pico no descarta un 1040 anterior. Consulta las variables de estado.
En MySQL 8.4 consulta Performance Schema, agrupando por cuenta/estado antes de revisar sesiones largas:
SELECT USER, COMMAND, COUNT(*) AS connection_count,
MAX(TIME) AS longest_state_seconds
FROM performance_schema.processlist
GROUP BY USER, COMMAND
ORDER BY connection_count DESC;
SELECT ID, USER, HOST, DB, COMMAND, TIME, STATE
FROM performance_schema.processlist
ORDER BY TIME DESC
LIMIT 50;
Relaciona cuenta, dirección, registros de aplicación y despliegue. HOST suele incluir el puerto del cliente: varios puertos pueden pertenecer a la misma aplicación. Ordenar solo por TIME no identifica la causa.
Ver otras cuentas requiere privilegios adecuados. Tablas no disponibles o monitorización incompleta pueden mostrar una lista parcial. Consulta estructura y visibilidad de processlist.
Sleep significa que la sesión no ejecuta una sentencia. Los pools conservan sesiones ociosas. Comprueba:
- Cantidad frente a réplicas, procesos y capacidad.
- Devolución, reutilización y retirada prevista después de las peticiones.
- Pools nuevos creados en cada petición o tarea.
- Conexiones retenidas en errores/cancelaciones y transacciones sin commit/rollback.
Una sesión ociosa puede mantener una transacción. Consulta InnoDB:
SELECT trx_mysql_thread_id, trx_started, trx_state
FROM information_schema.innodb_trx
ORDER BY trx_started;
Relaciona trx_mysql_thread_id con el ID de conexión. No termines una transacción solo por existir: revisa su función y esperas de bloqueo. Las transacciones largas ocupan conexiones y bloquean otras peticiones, amplificando latencia y presión.
Controla primero la aplicación que las genera. Los ID siguientes son ejemplos; usa objetivos recién comprobados:
KILL CONNECTION 12345;
KILL CONNECTION cierra la conexión y afecta su trabajo; una transacción pendiente puede revertirse y tardar. KILL QUERY detiene la sentencia pero conserva la conexión, por lo que no garantiza un espacio libre. Consulta KILL y sus privilegios.
No elimines todas las sesiones que superen un umbral arbitrario de Sleep ni interrumpas replicación, copias, administradores o pools legítimos. Si la aplicación reconecta inmediatamente, KILL solo vacía la lista un momento.
Configurar pool_size=10 no limita necesariamente todo el servicio a diez conexiones. Cada réplica puede ejecutar varios procesos con pools propios y conexiones de desbordamiento.
Para pools independientes por proceso, calcula réplicas × procesos por réplica × capacidad máxima del pool, más colas, tareas, administración y otros servicios. En SQLAlchemy QueuePool acotado, el máximo prestado depende de pool_size + max_overflow; consulta su documentación. Este presupuesto es hipotético, no una medición:
| Origen | Conexiones potenciales |
|---|---|
| API: 2 réplicas × 4 procesos × (10 del pool + 10 overflow) | 160 |
| Tareas de fondo | 20 |
| Otros sitios y tareas programadas | 10 |
| Reserva administrativa y monitorización | 10 |
| Total | 200 |
Puede superar un límite ordinario de 151. Es capacidad potencial: el pool no tiene por qué abrir todo al arrancar. Contrástala con datos reales.
Reduce capacidad, overflow y concurrencia innecesarios según demanda y rendimiento de la base. Conserva margen administrativo. Verifica devolución en éxito, errores y cancelación, commit/rollback oportunos e inicialización en el ciclo correcto del proceso. Recalcula al añadir réplicas/workers: un despliegue gradual mantiene temporalmente instancias nuevas y antiguas; reinicios y precalentamientos simultáneos generan picos.
Con uso razonable y margen de memoria/procesamiento, puede convenir un aumento moderado. En MySQL 8.4, max_connections es global y dinámico; los recursos pueden afectar el valor efectivo. Consulta las variables del sistema.
Comprueba memoria del host y límites del contenedor:
free -h
vmstat 1 5
docker stats --no-stream
Ejecuta el último comando solo con Docker. La memoria libre del host puede superar el límite del contenedor. El coste por conexión varía con buffers, tablas temporales y consultas. Poner 1000 sin medir puede transformar 1040 en OOM; consulta MySQL Docker y memoria.
200 es un ejemplo de sintaxis, no una recomendación. Registra el original y calcula el valor adecuado:
SET @incident_old_max_connections = @@GLOBAL.max_connections;
SELECT @incident_old_max_connections;
SET GLOBAL max_connections = 200;
SELECT @@GLOBAL.max_connections;
Necesitas privilegios administrativos. SET GLOBAL cambia el valor en ejecución sin reiniciar, pero normalmente no lo conserva tras el reinicio. No ajustes varios parámetros de memoria al mismo tiempo.
Para revertir en la misma sesión:
SET GLOBAL max_connections = @incident_old_max_connections;
La variable de sesión @incident_old_max_connections desaparece al desconectar: guarda también el número original en el registro del cambio. Tras reconectar, restaura explícitamente ese número. Bajar el límite no limpia sesiones existentes; evalúa el margen para las siguientes conexiones.
Cuando pools, métricas y actividad estén estables, elige una forma clara de gestionar la configuración. SET PERSIST cambia el valor actual y lo persiste:
SET PERSIST max_connections = 200;
Sustituye el ejemplo; consulta SET. Para retirar esa opción persistida:
RESET PERSIST max_connections;
RESET PERSIST elimina la persistencia sin restaurar el valor actual. Restáuralo por separado desde el registro. Consulta RESET PERSIST. Si gestionas archivos, confirma qué se carga para evitar contradicciones entre my.cnf, valores persistidos y argumentos del despliegue.
Recrear un contenedor no necesariamente elimina opciones persistidas en el directorio de datos. Conserva el volumen; la guía MySQL 8.4 con Docker cubre configuración, datos y copias.
wait_timeout controla sesiones ociosas, no consultas lentas activas. Un valor demasiado corto puede hacer que el pool reutilice conexiones cerradas por el servidor. Distingue ajustes globales de sesiones existentes y coordina timeout con reciclado, comprobación de conexiones y transacciones largas. Corrige primero fugas y ciclo del pool; ni 30 ni 60 segundos son universales.
Usa la cuenta y ruta originales para probar acceso, lectura, escritura y transacciones importantes. Reanuda gradualmente las tareas y observa un intervalo que incluya tráfico normal y trabajos programados:
Threads_connectedpermanece dentro del presupuesto y no crece continuamente.- No aumentan 1040 ni
Connection_errors_max_connections. - Latencia, esperas del pool, errores y memoria son aceptables.
- Despliegues y picos de colas/tareas mantienen margen.
Un acceso correcto o conexiones a cero tras reiniciar no acreditan la reparación. Guarda muestras, límites, configuración de pools y reversión para incluir la base de datos al ampliar la aplicación.