SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

MySQL «Too many connections» en un VPS: cómo arreglarlo

Antes de subir max_connections, averigua quién ocupa las conexiones: reproduce el error 1040, mata las conexiones dormidas, ajusta PHP-FPM y dimensiona por RAM.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, November 17, 2026.

Qué significa «Too many connections» en MySQL

El error «Too many connections» de MySQL (código 1040, ER_CON_COUNT_ERROR) significa que el servidor ya tiene abiertas todas las conexiones que permite max_connections, así que rechaza la siguiente. No es un fallo de disco ni de memoria. Es un contador que llegó a su tope. La reacción típica es copiar de un foro max_connections = 1000 y reiniciar. En un VPS de 2 o 4 GB eso cambia un error visible por un problema peor: el núcleo de Linux mata mysqld cuando se queda sin memoria.

Esta guía sigue otro orden. Primero mides quién ocupa las conexiones. Después reproduces el error a propósito, para entender qué ve la aplicación y qué ves tú como administrador. Solo al final cambias un número, y lo haces de forma que sobreviva a un reinicio.

Es un caso muy común al pasar de un hosting compartido a un VPS propio con WordPress, PrestaShop, Laravel o Moodle. En el hosting compartido el proveedor ajustaba MySQL por ti. En el VPS lo decides tú. Si todavía estás montando el servidor, empieza por montar una pila LAMP en Ubuntu 24.04 y vuelve aquí cuando aparezca el error.

Qué versión de MySQL tienes

Ubuntu no trae la misma serie de MySQL en sus dos LTS. Según el archivo de paquetes de Ubuntu (consultado el 17 de noviembre de 2026), Ubuntu 24.04 publica mysql-server 8.0.46 y Ubuntu 26.04 publica mysql-server 8.4.13 en sus repositorios de seguridad y de actualizaciones. La diferencia importa más abajo, porque un comando que verás en muchos foros ya no existe en 8.4.

sudo apt update && sudo apt install -y mysql-server
mysql --version

La salida debe nombrar una versión 8.0 en Ubuntu 24.04 y una versión 8.4 en Ubuntu 26.04. Apunta cuál tienes. Todo lo que dependa de la versión está marcado en esta guía.

Lee los contadores antes de tocar nada

Cuatro datos te dicen casi todo. Léelos en tu servidor, no los des por supuestos: el paquete de tu distribución puede fijar valores distintos a los del manual.

sudo mysql -e "SHOW VARIABLES LIKE 'max_connections'; SHOW GLOBAL STATUS WHERE Variable_name IN ('Threads_connected','Threads_running','Max_used_connections','Max_used_connections_time','Connection_errors_max_connections');"

Qué significa cada uno, según el manual de MySQL 8.4:

  • max_connections: el tope de conexiones de clientes. El manual de 8.4 documenta 151 por defecto, pero el valor que cuenta es el que imprime tu servidor.
  • Threads_connected: las conexiones abiertas ahora mismo.
  • Threads_running: los hilos que no están dormidos, es decir, los que de verdad ejecutan algo.
  • Max_used_connections y Max_used_connections_time: el máximo de conexiones simultáneas desde el arranque, y el momento en que se alcanzó.
  • Connection_errors_max_connections: cuántas conexiones se rechazaron porque se llegó a max_connections.

Si Max_used_connections es igual a max_connections y Connection_errors_max_connections es mayor que cero, el error ha ocurrido de verdad desde el último arranque. Max_used_connections_time te da la hora exacta, así que puedes cruzarla con el registro de acceso de Nginx o Apache y con tus tareas cron.

La pista más útil es comparar Threads_connected con Threads_running. Si hay 140 conexiones abiertas y solo 3 ejecutan algo, el servidor no está saturado de trabajo. Está lleno de conexiones dormidas que nadie cierra.

Quién ocupa las conexiones: el processlist

La tabla performance_schema.processlist muestra cada conexión con su usuario, su origen, lo que hace (COMMAND) y cuántos segundos lleva en ese estado (TIME). Para ver las conexiones de otros usuarios necesitas el privilegio PROCESS, y sudo mysql lo tiene.

sudo mysql -e "SELECT USER, SUBSTRING_INDEX(HOST, ':', 1) AS origen, COMMAND, COUNT(*) AS conexiones, MAX(TIME) AS max_segundos FROM performance_schema.processlist GROUP BY USER, origen, COMMAND ORDER BY conexiones DESC;"

Un resultado sano tiene pocas filas con Sleep y valores bajos en max_segundos. Un resultado con fugas tiene decenas de conexiones de tu usuario de aplicación en Sleep, con miles de segundos. Eso significa que algo abre conexiones y no las suelta. El SUBSTRING_INDEX quita el puerto del origen para que las conexiones TCP del mismo equipo se agrupen en una sola fila.

Reproducir el error 1040 a propósito

Provocar el error en un entorno controlado te enseña dos cosas: qué mensaje recibe la aplicación y por qué tú todavía puedes entrar. Hazlo en un servidor de pruebas o en un momento sin tráfico, porque durante unos minutos el servidor aceptará muy pocas conexiones.

Primero guarda el valor actual y crea una cuenta desechable sin privilegios. La contraseña va en un archivo de opciones con permisos 600, así no aparece en la lista de procesos ni en el historial del shell.

ORIG=$(sudo mysql -N -e "SELECT @@GLOBAL.max_connections")
echo "max_connections original: $ORIG"
sudo mysql -e "CREATE USER 'prueba'@'localhost' IDENTIFIED BY 'Prueba-Conexiones-2026';"
install -m 600 /dev/null ~/prueba.cnf
printf '[client]\nuser=prueba\npassword=Prueba-Conexiones-2026\n' > ~/prueba.cnf

Ahora baja el tope a 3 en caliente y abre tres sesiones que duermen diez minutos cada una:

sudo mysql -e "SET GLOBAL max_connections = 3;"
for i in 1 2 3; do
  mysql --defaults-extra-file=$HOME/prueba.cnf -e "SELECT SLEEP(600)" &
done
sleep 2
mysql --defaults-extra-file=$HOME/prueba.cnf -e "SELECT 1"

La última línea debe fallar con el error 1040 y el texto Too many connections. Copia el mensaje exacto que imprime tu cliente: es el mismo que verá tu aplicación PHP dentro de su propio mensaje de error. Si una de las tres sesiones en segundo plano ya falla, otra conexión ocupaba un hueco antes de empezar. El processlist te dirá cuál.

Con las tres plazas llenas, entra como administrador:

sudo mysql -e "SELECT ID, USER, COMMAND, TIME, INFO FROM performance_schema.processlist;"

Esta consulta funciona aunque el servidor está lleno. Debes ver las tres sesiones de prueba ejecutando SELECT SLEEP(600), más tu propia conexión.

Por qué sudo mysql entra cuando la aplicación no puede

El manual de MySQL 8.4 lo explica: mysqld permite en realidad max_connections + 1 conexiones de clientes. La conexión extra está reservada para cuentas con el privilegio CONNECTION_ADMIN o con el antiguo SUPER, que está obsoleto y se eliminará en una versión futura. Existe para que un administrador pueda ejecutar SHOW PROCESSLIST cuando todas las plazas normales están ocupadas.

El usuario root de MySQL tiene todos los privilegios. Compruébalo así:

sudo mysql -e "SHOW GRANTS FOR CURRENT_USER()\G" | grep -o CONNECTION_ADMIN

Si imprime CONNECTION_ADMIN, ese usuario tiene la plaza de reserva. De aquí sale una regla práctica: tu usuario de aplicación nunca debe tener CONNECTION_ADMIN ni SUPER. Si lo tiene, la aplicación puede ocupar también la plaza de reserva, y cuando todo se llena ya no queda hueco para que tú entres a diagnosticar.

Matar las conexiones y limpiar

KILL termina una conexión por su ID. Una cuenta siempre puede matar sus propios hilos. Para matar los de otra cuenta hace falta CONNECTION_ADMIN. Esta línea genera un KILL por cada sesión de prueba y los ejecuta:

sudo mysql -N -e "SELECT CONCAT('KILL ', ID, ';') FROM performance_schema.processlist WHERE USER='prueba'" | sudo mysql
wait

Cada cliente en segundo plano imprime un error al perder su conexión. Es lo esperado. wait espera a que terminen los tres. Después restaura el tope original y borra la cuenta:

sudo mysql -e "SET GLOBAL max_connections = $ORIG; DROP USER 'prueba'@'localhost';"
rm ~/prueba.cnf
sudo mysql -e "SHOW VARIABLES LIKE 'max_connections';"

La última consulta debe mostrar el valor que guardaste en $ORIG. Si cerraste la terminal entre medias, la variable se perdió: vuelve a poner el valor que anotaste al principio.

Arreglo 1: encontrar la fuga de conexiones dormidas

Una conexión en estado Sleep ocupa una plaza aunque no haga nada. El servidor la cierra sola cuando pasa wait_timeout sin actividad. Según el manual de 8.4, wait_timeout vale 28800 segundos por defecto, es decir, ocho horas, y se aplica a conexiones no interactivas como las de PHP. Una conexión olvidada puede ocupar su plaza durante ocho horas.

La causa más habitual en PHP son las conexiones persistentes. Si tu aplicación usa PDO::ATTR_PERSISTENT o el prefijo p: de mysqli, cada proceso PHP-FPM puede guardar su propia conexión abierta entre peticiones. Con muchos procesos, eso son muchas plazas ocupadas en Sleep. Otras causas: un worker de colas de Laravel que abre una conexión y vive horas, o un script de cron que se cuelga.

Para ver las conexiones dormidas más antiguas de tu aplicación (cambia app por tu usuario):

sudo mysql -e "SELECT ID, SUBSTRING_INDEX(HOST, ':', 1) AS origen, DB, TIME FROM performance_schema.processlist WHERE USER='app' AND COMMAND='Sleep' ORDER BY TIME DESC LIMIT 20;"

Si ves conexiones con miles de segundos, puedes liberarlas ya con el mismo patrón de KILL de antes, filtrando por COMMAND='Sleep' AND TIME > 300. Esto es un parche. La solución real es quitar la conexión persistente o arreglar el proceso que no cierra. Como red de seguridad, baja wait_timeout para que el servidor cierre antes lo que se quede colgado:

sudo mysql -e "SET GLOBAL wait_timeout = 600; SHOW GLOBAL VARIABLES LIKE 'wait_timeout';"

El valor global solo afecta a las conexiones nuevas. Las que ya estaban abiertas conservan el suyo. Más abajo verás cómo hacer que el cambio sobreviva a un reinicio.

Arreglo 2: la cuenta de PHP-FPM

Cada proceso hijo de PHP-FPM atiende una petición a la vez, y casi cada petición de WordPress o PrestaShop abre una conexión a MySQL. El manual de PHP define pm.max_children como el límite de peticiones simultáneas que atiende un pool. Es obligatorio en cada pool. Por eso la suma de pm.max_children de todos tus pools es el número máximo de conexiones que PHP-FPM puede abrir a la vez.

grep -R "^pm.max_children" /etc/php/*/fpm/pool.d/

La cuenta que debe cumplirse es sencilla. Suma pm.max_children de todos los pools. Añade los procesos que no pasan por PHP-FPM: workers de colas de Laravel, el cron de Moodle, los scripts de copia de seguridad, wp-cli. Deja un margen para ti y para picos. Ese total tiene que quedar por debajo de max_connections.

Un ejemplo: dos pools con pm.max_children = 20, dos workers de colas y un cron dan 43 conexiones como máximo. Con un max_connections de 151 el margen sobra, y el error solo puede venir de una fuga o de otra aplicación. Si en cambio la suma supera max_connections, el error aparecerá en cada pico de tráfico, y la solución correcta suele ser bajar pm.max_children, no subir MySQL.

En WordPress, WP-Cron lanza tareas dentro de peticiones web normales, y cada una ocupa un proceso PHP y una conexión. Si quieres que esas tareas corran a una hora fija y fuera del tráfico, sigue la guía para desactivar WP-Cron y usar el cron del sistema. Una caché de objetos Redis para WordPress reduce las consultas por petición, pero no el número de conexiones simultáneas: cada petición PHP sigue abriendo la suya.

Arreglo 3: dimensiona por RAM, no por el foro

Cada conexión activa usa memoria propia dentro de mysqld, y cada proceso de PHP-FPM usa la suya en el sistema. Subir max_connections a 1000 no crea memoria. Solo permite que MySQL intente usar más de la que tiene el VPS. Cuando la RAM se acaba, el OOM killer (el mecanismo del núcleo Linux que mata procesos cuando falta memoria) elige una víctima, y en un VPS con base de datos suele ser mysqld, porque es el proceso más grande.

Mira si ya te ha pasado:

sudo journalctl -k | grep -i -E "out of memory|oom-kill"
free -m

Si journalctl muestra líneas que nombran mysqld, el problema no era el número de conexiones. Era la memoria, y subir el tope lo empeora.

Para decidir un número con datos, mide la memoria real de tus procesos en hora punta:

ps -eo rss,comm | awk '/php-fpm/ {s+=$1; n++} END {if (n) printf "php-fpm: %d procesos, media %d MB\n", n, s/n/1024}'
ps -o rss= -C mysqld | awk '{printf "mysqld: %d MB\n", $1/1024}'

Con la media por proceso PHP sabes cuántos hijos caben en la RAM que no usa MySQL. Ese número fija pm.max_children, y pm.max_children fija las conexiones que necesitas. Así max_connections sale de la memoria del servidor, no de una cifra redonda. Si el resultado no basta para tu tráfico, la respuesta es más RAM o menos procesos por petición, no un tope más alto. En PostgreSQL el problema se resuelve con un intermediario delante de la base de datos, como se explica en pooling de conexiones en PostgreSQL en un VPS; en una pila PHP con MySQL, la cuenta de PHP-FPM cumple casi siempre ese papel.

Arreglo 4: que el cambio sobreviva a un reinicio

SET GLOBAL cambia el valor en memoria. Al reiniciar mysqld vuelve el valor del archivo de configuración. Tienes dos formas de hacerlo permanente en MySQL.

Opción A, SET PERSIST. Según el manual de 8.4, SET PERSIST cambia el valor global en caliente y además lo escribe en mysqld-auto.cnf, dentro del directorio de datos. SET PERSIST_ONLY escribe el archivo sin tocar el valor actual. Necesitas SYSTEM_VARIABLES_ADMIN, que root tiene.

sudo mysql -e "SET PERSIST max_connections = 200; SET PERSIST wait_timeout = 600;"
sudo mysql -e "SELECT @@datadir; SELECT * FROM performance_schema.persisted_variables;"

La segunda consulta debe listar las dos variables. Ventaja: no editas archivos. Inconveniente: el valor vive en el directorio de datos, no en /etc, y quien revise la configuración más tarde puede no encontrarlo. Un valor en mysqld-auto.cnf gana al del archivo de /etc/mysql.

Opción B, mysqld.cnf. En Ubuntu 24.04 el paquete mysql-server-8.0 instala /etc/mysql/mysql.conf.d/mysqld.cnf. En 26.04 comprueba qué archivos hay con ls /etc/mysql/mysql.conf.d/ antes de editar. Añade las líneas en la sección [mysqld]:

[mysqld]
max_connections = 200
wait_timeout = 600
sudo systemctl restart mysql
sudo mysql -e "SHOW VARIABLES WHERE Variable_name IN ('max_connections','wait_timeout');"

Si la consulta no muestra tus valores, revisa performance_schema.persisted_variables: un SET PERSIST antiguo puede estar tapando el archivo. Si mysqld no arranca tras el cambio, lee sudo journalctl -u mysql -n 50. Un error de sintaxis en el archivo aparece ahí.

Y si en realidad usas MariaDB

En Debian, el paquete default-mysql-server depende de mariadb-server-compat, así que apt install default-mysql-server te deja MariaDB con los nombres de comando de MySQL. Confírmalo con apt-cache depends default-mysql-server y con mysql --version, que nombra MariaDB.

No cuentes con SET PERSIST en MariaDB. Su documentación de variables del servidor dice que lo que cambias con SET no se mantiene tras un reinicio, y la petición para añadir SET PERSIST (MDEV-19036) está cerrada como duplicada sin versión que la incluya. El cambio permanente va en un archivo. En Debian 13 el paquete mariadb-server instala /etc/mysql/mariadb.conf.d/50-server.cnf: pon las líneas en su sección [mysqld] y reinicia el servicio. MariaDB documenta los mismos valores por defecto que el manual de MySQL 8.4 para estas variables, y también reserva una conexión para un usuario con SUPER o CONNECTION ADMIN. En MariaDB, usa SHOW PROCESSLIST en lugar de performance_schema.processlist.

Los dos errores que se confunden con este

«Host … is blocked because of many connection errors»

Este es el error 1129 (ER_HOST_IS_BLOCKED). Su texto es Host '%s' is blocked because of many connection errors; unblock with 'mysqladmin flush-hosts', donde %s es tu equipo. No tiene nada que ver con max_connections. MySQL cuenta los intentos de conexión interrumpidos de cada equipo, y tras max_connect_errors intentos seguidos bloquea ese equipo. El manual de 8.4 documenta 100 como valor por defecto. Una conexión correcta antes de llegar al límite pone el contador a cero.

Suele pasar con una aplicación en otro servidor que tiene mal la contraseña o un cortafuegos que corta la conexión a medias. Si el equipo remoto ni siquiera llega al puerto, el error es otro: antes de nada, comprueba si el puerto 3306 está abierto. Para desbloquear, el manual de 8.4 da dos vías que funcionan en las dos versiones:

sudo mysql -e "TRUNCATE TABLE performance_schema.host_cache;"
sudo mysqladmin flush-hosts

Cuidado con la sentencia FLUSH HOSTS que verás en muchos foros. Se declaró obsoleta en MySQL 8.0.23 y se eliminó en MySQL 8.4. En Ubuntu 24.04 (8.0.46) todavía existe pero está obsoleta. En Ubuntu 26.04 (8.4.13) ya no existe. MariaDB todavía la documenta. Desbloquear sin arreglar la causa solo te da tiempo: el bloqueo vuelve cuando el equipo acumule otros 100 errores.

El límite por usuario: max_user_connections

max_user_connections limita cuántas conexiones simultáneas puede abrir una misma cuenta. El valor global por defecto es 0, que significa sin límite. Cada cuenta puede tener su propio límite con MAX_USER_CONNECTIONS. Si el de la cuenta es 0, manda el global. En un hosting compartido el proveedor puede fijar este límite por cuenta. En tu VPS lo decides tú.

El manual nombra dos errores posibles para este caso: 1203 (ER_TOO_MANY_USER_CONNECTIONS, plantilla User %s already has more than 'max_user_connections' active connections) y 1226 (ER_USER_LIMIT_REACHED, plantilla User '%s' has exceeded the '%s' resource (current value: %ld)). Para ver cuál devuelve tu servidor, reprodúcelo con la cuenta de prueba de antes (vuelve a crearla y a crear ~/prueba.cnf si ya la borraste):

sudo mysql -e "ALTER USER 'prueba'@'localhost' WITH MAX_USER_CONNECTIONS 1;"
mysql --defaults-extra-file=$HOME/prueba.cnf -e "SELECT SLEEP(120)" &
sleep 2
mysql --defaults-extra-file=$HOME/prueba.cnf -e "SELECT 1"

La segunda conexión debe fallar con uno de esos dos códigos. Copia el mensaje: si tu aplicación muestra ese texto, el problema es el límite de la cuenta, y subir max_connections no cambia nada. Limpia igual que antes: mata la sesión con KILL, ejecuta wait, borra la cuenta con DROP USER y borra ~/prueba.cnf.

FAQ

¿Por qué sale «Too many connections» si mi web tiene pocas visitas?

Casi siempre por conexiones dormidas. Compara Threads_connected con Threads_running: muchas conexiones abiertas y pocas en ejecución significan que algo abre conexiones y no las cierra. Mira performance_schema.processlist filtrando por COMMAND='Sleep'. Las conexiones persistentes de PHP y los workers de colas son las causas más habituales. Con el wait_timeout documentado por defecto, de 28800 segundos, una conexión olvidada ocupa su plaza durante ocho horas.

¿Puedo poner max_connections = 1000 y olvidarme?

En un VPS de 2 o 4 GB, no. Cada conexión activa usa memoria, y si la suma pasa la RAM disponible el OOM killer del núcleo mata un proceso, normalmente mysqld. Calcula el número a partir de la suma de pm.max_children de tus pools de PHP-FPM, más los workers y el cron, más un margen. Si ese número no basta, necesitas más RAM o menos procesos, no un tope más alto.

¿Cómo desbloqueo un host bloqueado por «many connection errors»?

Ese es el error 1129, y lo controla max_connect_errors, no max_connections. Ejecuta TRUNCATE TABLE performance_schema.host_cache o mysqladmin flush-hosts. La sentencia FLUSH HOSTS está obsoleta en MySQL 8.0 y se eliminó en MySQL 8.4, así que en Ubuntu 26.04 falla. Después busca la causa: contraseñas incorrectas o conexiones cortadas por un cortafuegos desde ese equipo.

¿Por qué root entra en MySQL cuando mi aplicación recibe el error 1040?

MySQL permite max_connections + 1 conexiones. La conexión extra está reservada para cuentas con CONNECTION_ADMIN o con el antiguo SUPER, y root tiene ambos. Sirve para que un administrador pueda ejecutar SHOW PROCESSLIST y KILL con el servidor lleno. Por eso tu usuario de aplicación no debe tener esos privilegios: si los tiene, puede ocupar también esa plaza de reserva.

¿Te resultó útil este artículo?