Solucionar 'Too many connections' MySQL | Syspanel

¿Qué significa el error "Too many connections" en MySQL?

Si estás leyendo esto, probablemente has visto un mensaje como este en tu aplicación web o al intentar acceder a phpMyAdmin:

"Too many connections"

O quizás algo más técnico como:

"ERROR 1040 (08004): Too many connections"

No te preocupes, es uno de los errores más comunes en servidores con MySQL o MariaDB, y lo bueno es que tiene solución. Vamos a explicarte paso a paso qué significa, por qué ocurre y cómo solucionarlo desde Syspanel, el panel de control que usamos en nuestros planes de hosting y que puedes acceder por el puerto 2106 (por ejemplo: https://tu-dominio.com:2106).

¿Por qué ocurre este error?

Imagina que MySQL es un restaurante con un número limitado de mesas. Cada vez que una aplicación (WordPress, PrestaShop, una API, etc.) necesita acceder a la base de datos, "ocupa una mesa". Si todas las mesas están ocupadas y llega un nuevo cliente, el restaurante le dice: "lo sentimos, no hay espacio".

En términos técnicos, MySQL tiene un límite llamado max_connections. Este valor define cuántas conexiones simultáneas puede aceptar el servidor de bases de datos. Cuando se supera ese límite, MySQL rechaza nuevas conexiones y devuelve el error "Too many connections".

Causas más frecuentes

Aplicaciones con muchas consultas simultáneas: Un plugin de WordPress mal optimizado, un script con bucles infinitos o un proceso que no cierra conexiones.
Picos de tráfico inesperados: Un artículo viral, una campaña de email marketing o un ataque de fuerza bruta pueden saturar las conexiones.
Conexiones que no se cierran: Algunas aplicaciones (o versiones antiguas de PHP) no cierran correctamente las conexiones a la base de datos, dejándolas "colgadas".
Configuración demasiado baja: En algunos servidores compartidos, el valor de max_connections es muy restrictivo (por ejemplo, 30 o 50), y cualquier sitio con algo de tráfico lo agota.
Procesos zombie o dormidos: Consultas que quedan en estado "Sleep" durante mucho tiempo y ocupan un hueco sin hacer nada útil.

Primeros pasos: accede a Syspanel

Para solucionar este problema, necesitas acceder a Syspanel. Recuerda:

[INFO] Syspanel es el nombre que damos a nuestro panel de control (basado en HestiaCP). Para acceder, abre tu navegador y escribe https://tu-dominio.com:2106. Introduce tu usuario y contraseña de administrador.

Una vez dentro, verás el panel principal con todas las opciones de gestión de tu servidor: dominios, cuentas de correo, bases de datos, estadísticas, etc.

Solución 1: Aumentar el límite de max_connections desde Syspanel

La solución más directa es aumentar el número máximo de conexiones permitidas. Esto se hace editando el archivo de configuración de MySQL/MariaDB.

Paso 1: Localiza el archivo de configuración

En Syspanel, ve a la sección "Servidor" o "Configuración" (dependiendo de la versión, puede variar ligeramente). Busca la opción que dice "Bases de datos" o "MySQL".

[TIP] Si no encuentras la opción de editar el archivo de configuración directamente desde el panel, puedes usar el Administrador de archivos de Syspanel. La ruta típica es /etc/mysql/my.cnf o /etc/my.cnf. También puedes encontrarlo en /etc/mysql/mariadb.conf.d/50-server.cnf si usas MariaDB.

Paso 2: Edita el valor de max_connections

Abre el archivo con el editor de texto de Syspanel (o con el editor que prefieras). Busca la línea que dice:

max_connections = 150

Si no existe, puedes añadirla en la sección [mysqld]. Por ejemplo:

[mysqld]
max_connections = 300

[WARNING] No pongas un valor demasiado alto (como 10000) sin necesidad. Cada conexión consume memoria RAM. Un valor de 150 a 500 suele ser suficiente para la mayoría de sitios. Si tienes un VPS con poca RAM, ten cuidado.

Paso 3: Guarda y reinicia MySQL

Guarda los cambios y reinicia el servicio de MySQL/MariaDB. En Syspanel, ve a "Servicios" y busca mysql o mariadb. Haz clic en "Reiniciar".

También puedes hacerlo por línea de comandos (si tienes acceso SSH):

sudo systemctl restart mysql

O para MariaDB:

sudo systemctl restart mariadb

Solución 2: Identificar y matar procesos que bloquean conexiones

A veces, el problema no es que falten conexiones, sino que hay procesos zombie que ocupan conexiones sin hacer nada. Puedes verlos y matarlos desde Syspanel.

Paso 1: Accede a la terminal de Syspanel

En Syspanel, busca la opción "Terminal" o "Consola" (normalmente en el menú de la izquierda). Se abrirá una ventana con acceso a la terminal de tu servidor.

Paso 2: Consulta los procesos activos

Escribe el siguiente comando para ver todas las conexiones activas:

SHOW PROCESSLIST;

Pero para que funcione, primero debes entrar en MySQL. Puedes hacerlo con:

mysql -u admin -p

Te pedirá la contraseña de administrador de MySQL (la misma que usas para phpMyAdmin). Luego ejecuta:

SHOW PROCESSLIST;

Verás una lista con columnas como Id, User, Host, db, Command, Time, State e Info.

Paso 3: Identifica los procesos dormidos

Busca filas donde Command sea Sleep y Time sea muy alto (por ejemplo, más de 300 segundos). Esos son procesos que están "dormidos" y ocupan conexiones innecesariamente.

Paso 4: Mata los procesos problemáticos

Para terminar un proceso, usa el comando KILL seguido del Id del proceso. Por ejemplo:

KILL 12345;

Si hay muchos procesos dormidos, puedes matarlos todos de una vez con este comando (cuidado, solo los que sean Sleep):

-- Ver los IDs de procesos Sleep
SELECT GROUP_CONCAT(id) FROM information_schema.processlist WHERE command = 'Sleep';

Luego copia la lista de IDs y ejecuta:

KILL 12345, 12346, 12347;

[TIP] Si no te sientes cómodo con la terminal, también puedes hacer esto desde phpMyAdmin (accesible desde Syspanel en la sección "Bases de datos"). Dentro de phpMyAdmin, ve a la pestaña "Procesos" y finaliza los que quieras.

Solución 3: Optimizar tu aplicación para que no abuse de las conexiones

Si el error es recurrente, es señal de que tu aplicación necesita optimización. Aquí tienes algunas recomendaciones prácticas:

3.1. Usa un plugin de caché en WordPress

Si usas WordPress, instala un plugin de caché como W3 Total Cache o WP Super Cache. Esto reduce drásticamente las consultas a la base de datos.

3.2. Optimiza las consultas SQL

Si tienes un desarrollo a medida, revisa las consultas más lentas. Puedes activar el log de consultas lentas en MySQL para identificarlas. En el archivo de configuración, añade:

slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow-queries.log
long_query_time = 2

Esto registrará las consultas que tarden más de 2 segundos.

3.3. Usa conexiones persistentes con moderación

En PHP, la función mysql_pconnect (o la opción PDO::ATTR_PERSISTENT) mantiene conexiones abiertas entre peticiones. Aunque parece eficiente, puede agotar el límite de conexiones si no se configura bien. Si no sabes lo que haces, desactívalo.

3.4. Aumenta la memoria de MySQL

Si tu servidor tiene RAM suficiente, puedes aumentar el tamaño del buffer para que las consultas sean más rápidas y las conexiones se liberen antes. En el archivo de configuración:

innodb_buffer_pool_size = 512M

[WARNING] Este valor depende de la RAM total de tu servidor. Como regla general, usa el 50-70% de la RAM disponible. En Syspanel, puedes ver el consumo de memoria en la sección "Estadísticas".

Solución 4: Cambiar el número de conexiones por usuario

En MySQL, además del límite global (max_connections), existe un límite por usuario llamado max_user_connections. Si tienes varias aplicaciones usando el mismo usuario de base de datos, este límite puede ser el culpable.

Para ver el límite actual de tu usuario:

SHOW VARIABLES LIKE 'max_user_connections';

Para cambiarlo en tiempo real (sin reiniciar MySQL):

SET GLOBAL max_user_connections = 200;

Pero recuerda que este cambio se pierde al reiniciar. Para hacerlo permanente, añade al archivo de configuración:

[mysqld]
max_user_connections = 200

Solución 5: Reiniciar MySQL (último recurso)

Si el error ocurre de forma repentina y necesitas una solución rápida, reiniciar MySQL libera todas las conexiones. Es como "apagar y encender" el restaurante para que las mesas se desocupen.

Desde Syspanel, ve a "Servicios" → busca mysql o mariadb → clic en "Reiniciar".

[WARNING] Al reiniciar MySQL, todas las conexiones activas se cerrarán. Las consultas en curso se interrumpirán. Es recomendable hacerlo en momentos de bajo tráfico.

Preguntas frecuentes (FAQ)

¿Cuál es el valor recomendado para max_connections?

Depende de la RAM de tu servidor. Como referencia:

Servidor con 1 GB RAM: 100-150 conexiones
Servidor con 2 GB RAM: 200-300 conexiones
Servidor con 4 GB RAM o más: 300-500 conexiones

¿Cómo puedo saber el número actual de conexiones en mi servidor?

Ejecuta este comando en MySQL:

SHOW STATUS LIKE 'Threads_connected';

¿El error "Too many connections" puede ser un ataque?

Sí, en algunos casos es un ataque de fuerza bruta o un script malicioso que abre muchas conexiones. Si sospechas de esto, revisa los logs de acceso de tu servidor y considera usar un firewall o limitar el número de conexiones por IP.

¿Qué hago si el error persiste después de aumentar max_connections?

Si el problema continúa, es probable que tu aplicación tenga un bug de conexiones no cerradas. Te recomendamos:

Revisar el código de tu aplicación.
Actualizar PHP a una versión más reciente.
Contactar con nuestro soporte técnico desde Syspanel (sección "Soporte" o "Ticket").

Resumen rápido: pasos para solucionar el error

Accede a Syspanel por https://tu-dominio.com:2106.
Aumenta max_connections en el archivo de configuración de MySQL.
Reinicia MySQL desde Syspanel o por terminal.
Revisa los procesos activos y mata los que estén dormidos.
Optimiza tu aplicación (caché, consultas, etc.).
Si nada funciona, contacta con soporte.

Conclusión

El error "Too many connections" en MySQL puede parecer grave, pero en la mayoría de los casos se resuelve en pocos minutos ajustando un par de valores o reiniciando el servicio. Desde Syspanel tienes todas las herramientas necesarias para diagnosticarlo y solucionarlo sin necesidad de ser un experto en servidores.

Recuerda que la prevención es clave: mantén tu aplicación optimizada, usa caché y monitoriza el número de conexiones periódicamente. Si en cualquier momento te sientes perdido, nuestro equipo de soporte está disponible para ayudarte a través de Syspanel.

[INFO] Si este artículo te ha sido útil, compártelo con otros administradores de servidores que puedan estar pasando por el mismo problema. Y si tienes más dudas, no dudes en abrir un ticket de soporte desde Syspanel, estaremos encantados de ayudarte.

Este artículo fue escrito pensando en usuarios sin experiencia técnica, pero con ganas de aprender. Si necesitas más detalles sobre algún paso, consulta la documentación de Syspanel o contacta con soporte.