Solucionar Error 'Can't connect to MySQL server' en cPanel y Plesk | Guía 2024

¡Hola! Si estás leyendo esto, es muy probable que hayas visto un mensaje de error bastante frustrante al intentar conectar tu aplicación web (WordPress, Joomla, una tienda online, etc.) a su base de datos. El temido "Can't connect to local MySQL server" (No se puede conectar al servidor MySQL local) es uno de los errores más comunes en el mundo del hosting, pero no te preocupes: en la gran mayoría de los casos tiene una solución sencilla.

Este error significa, literalmente, que tu aplicación no puede hablar con el motor de base de datos. Es como si intentaras llamar por teléfono a alguien, pero la línea estuviera caída o marcaras un número equivocado. A lo largo de esta guía extensa, vamos a desglosar todas las causas posibles y, paso a paso, te enseñaremos a solucionar conexión mysql tanto en el panel de control cPanel como en Plesk. Vamos a ello.

Entendiendo el Error: ¿Qué significa realmente "Can't connect to local MySQL server"?

Antes de lanzarnos a tocar cosas, es vital entender qué está pasando. Cuando ves "mysql server error" en pantalla, no siempre significa que tu base de datos haya sido borrada o hackeada. Las causas más frecuentes son:

El servicio MySQL/MariaDB está caído: El servidor de bases de datos se ha detenido por un reinicio, un fallo del sistema o un error de configuración.
Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos en tu archivo de configuración (como wp-config.php en WordPress) no coinciden con los reales.
Problemas de red o socket: La aplicación intenta conectarse a un puerto o un archivo de socket (un "canal" de comunicación interno) que no es el correcto.
Sobrecarga del servidor: En ocasiones, el servidor MySQL tiene demasiadas conexiones abiertas y rechaza nuevas peticiones temporalmente.
Permisos de usuario: El usuario de la base de datos no tiene permisos para conectarse desde el host desde el que se intenta la conexión (normalmente localhost).

A continuación, te mostramos cómo diagnosticar y arreglar cada uno de estos puntos, dependiendo de si tu hosting usa cPanel o Plesk.

Parte 1: Solucionar el Error en cPanel

cPanel es uno de los paneles más utilizados. Si tu error aparece aquí, sigue estos pasos en orden, del más simple al más complejo.

### Paso 1: Verifica el estado del servicio MySQL en cPanel (WHM)

Si tienes acceso a WHM (Web Host Manager) como administrador, este es el primer lugar donde debes mirar. Si eres usuario final sin acceso a WHM, salta al Paso 2.

Inicia sesión en tu WHM (normalmente en https://tu-dominio.com:2087).
En la barra de búsqueda, escribe "Restart Services" (Reiniciar Servicios).
Haz clic en "Restart MySQL Server" (Reiniciar Servidor MySQL) o "Restart MariaDB".
Confirma el reinicio. Esto a menudo revive el servicio si estaba colgado.

[INFO] Si no tienes WHM, contacta a tu proveedor de hosting y pídeles que verifiquen el estado del servicio MySQL. Es la causa más común y la solución más rápida.

### Paso 2: Revisa el archivo de configuración de tu aplicación (wp-config.php)

El siguiente paso es asegurarte de que tu aplicación tiene los datos correctos. Para WordPress, el archivo es wp-config.php. Para otras aplicaciones, busca config.php, .env o settings.php.

Accede a tu Administrador de Archivos en cPanel (normalmente en la sección "Archivos").
Navega hasta la carpeta public_html (o la carpeta donde esté tu sitio).
Busca el archivo wp-config.php y haz clic derecho > Editar.
Busca estas líneas y verifica que sean correctas:
```
define('DB_NAME', 'tu_usuario_basededatos');
define('DB_USER', 'tu_usuario_mysql');
define('DB_PASSWORD', 'tu_contraseña_mysql');
define('DB_HOST', 'localhost');
```
- DB_NAME y DB_USER suelen tener el prefijo de tu cuenta en cPanel (ej. usuario_wpdb).
- DB_PASSWORD debe ser exactamente la que creaste.
- DB_HOST casi siempre es localhost, pero a veces puede ser 127.0.0.1 o un host remoto específico que te haya dado tu proveedor. Si cambiaste esto recientemente, ese es el problema.

[WARNING] ¡Cuidado! No cambies la contraseña en el archivo si no la has cambiado también en cPanel. Si lo haces, romperás la conexión. Si no estás seguro de la contraseña, es mejor cambiarla desde cPanel (Paso 3).

### Paso 3: Cambia la contraseña del usuario MySQL desde cPanel

Si sospechas que la contraseña es incorrecta, la forma más segura de arreglarlo es actualizarla directamente desde el panel.

Ve a la sección "Bases de Datos MySQL" en cPanel.
Busca tu usuario en la lista de "Usuarios MySQL".
Haz clic en "Cambiar contraseña" al lado del usuario correspondiente.
Escribe una contraseña nueva y segura (puedes usar el generador).
IMPORTANTE: Ahora debes actualizar la contraseña en el archivo wp-config.php (o el que corresponda) con la nueva contraseña que acabas de crear.

### Paso 4: Verifica los permisos del usuario y la conexión

Asegúrate de que el usuario de la base de datos esté vinculado a la base de datos correcta.

En la sección "Bases de Datos MySQL" de cPanel, baja hasta "Añadir Usuario a Base de Datos".
Selecciona tu usuario y tu base de datos en los menús desplegables y haz clic en "Añadir".
Marca la casilla "TODOS LOS PRIVILEGIOS" y haz clic en "Hacer cambios".

Parte 2: Solucionar el Error en Plesk

Plesk tiene una estructura diferente, pero los pasos lógicos son similares.

### Paso 1: Reinicia el servicio de bases de datos en Plesk

Si tienes acceso de administrador a Plesk, puedes reiniciar el servicio desde la interfaz.

Inicia sesión en Plesk.
Ve a "Herramientas y configuración" (Tools & Settings) en el menú de la izquierda.
En la sección "Servidor", busca el enlace "Servicios" (Services).
Busca el servicio "MySQL" o "MariaDB" en la lista.
Haz clic en el icono de "Reiniciar" (normalmente un círculo con una flecha).

### Paso 2: Comprueba la configuración de la base de datos en Plesk

Plesk te permite ver los detalles de conexión directamente desde el panel de la suscripción.

Ve a tu Suscripción (dominio) y haz clic en "Bases de datos" en el menú de la izquierda.
Haz clic en el nombre de la base de datos que está fallando.
Aquí verás el nombre de la base de datos, el usuario y podrás cambiar la contraseña.
Compara estos datos con los que tienes en tu archivo de configuración (wp-config.php o similar).

[TIP] En Plesk, es común que el host de la base de datos sea localhost. Si estás usando una IP externa o un puerto especial, asegúrate de que esté permitido en el cortafuegos del servidor.

### Paso 3: Usa PHPMyAdmin para probar la conexión

Una forma infalible de saber si las credenciales son correctas es intentar entrar con ellas manualmente.

En Plesk, dentro de la sección "Bases de datos", haz clic en el enlace "phpMyAdmin".
Si se abre automáticamente, significa que el servicio funciona. Ahora, intenta cerrar sesión y volver a entrar con el usuario y contraseña que tienes en tu archivo de configuración.
Si no puedes entrar, el problema son las credenciales. Cambia la contraseña en Plesk y actualízala en tu aplicación.

Parte 3: Soluciones Avanzadas (Para cuando nada de lo anterior funciona)

Si has llegado hasta aquí y el "error mysql cpanel" o el "no conecta mysql plesk" persiste, el problema puede ser más profundo. No te preocupes, aún hay esperanza.

### Solución 1: Revisa el archivo de configuración de MySQL (my.cnf o my.ini)

A veces, el archivo de configuración del servidor MySQL tiene una línea que limita el número de conexiones o que está configurado para escuchar en un socket incorrecto.

[WARNING] Este paso requiere acceso SSH al servidor. Si no sabes qué es SSH, no lo intentes. Contacta con tu soporte técnico y muéstrales este artículo. Hacer cambios incorrectos aquí puede tumbar el servidor entero.

Un error típico es que el archivo my.cnf tenga la línea skip-networking activada, lo que impide conexiones TCP/IP (aunque localhost suele funcionar). O que bind-address esté configurado para una IP específica que no es 127.0.0.1.

La solución sería comentar esas líneas (poner un # al principio) o cambiarlas a:

bind-address = 127.0.0.1
# skip-networking

Después, reinicia MySQL con: systemctl restart mysql (o mariadb).

### Solución 2: Problemas de permisos de archivos y carpetas

Asegúrate de que el directorio de datos de MySQL (normalmente /var/lib/mysql) tiene los permisos correctos para el usuario mysql.

chown -R mysql:mysql /var/lib/mysql
chmod -R 755 /var/lib/mysql

### Solución 3: El socket de MySQL no existe o está mal ubicado

Si tu aplicación intenta conectarse a través de un socket (archivo) en lugar de TCP/IP, y ese archivo no existe, verás el error. La ruta típica del socket es /var/run/mysqld/mysqld.sock.

Puedes verificar si existe con:

ls -la /var/run/mysqld/mysqld.sock

Si no existe, puede que el servicio no esté corriendo. Intenta arrancarlo:

systemctl start mysql

### Solución 4: Migración a Syspanel (HestiaCP)

En algunos casos, si tu proveedor de hosting está migrando de cPanel/Plesk a un panel más moderno como Syspanel (la versión renombrada de HestiaCP), es posible que los servicios se reinicien y las rutas cambien temporalmente.

[INFO] Si tu hosting usa Syspanel, el acceso a su panel de control se realiza a través del puerto 2106 (ej. https://tu-dominio.com:2106). Si estás en un proceso de migración, es posible que las bases de datos se estén moviendo de servidor y por eso ves el error. Contacta con tu proveedor para confirmar si están en mantenimiento.

Preguntas Frecuentes (FAQ)

Para terminar, respondemos a las dudas más habituales que nos llegan al soporte.

P: ¿Por qué veo "Can't connect to local MySQL server" solo en mi móvil y no en mi PC?
R: Es muy extraño, ya que el error es del servidor. Probablemente tu móvil esté conectado a una red WiFi que bloquea ciertos puertos, o tu aplicación móvil esté configurada con una IP de conexión distinta. Prueba a desconectar el WiFi y usar datos móviles.

P: ¿Pierdo mis datos si reinicio el servicio MySQL?
R: No. Reiniciar el servicio es como apagar y encender un electrodoméstico. Los datos están guardados en el disco duro y no se borran. Es la primera medida de seguridad que debes tomar.

P: El error dice "Access denied for user 'admin'@'localhost'". ¿Qué hago?
R: Este es un error de permisos. El usuario existe, pero la contraseña es incorrecta o no tiene permisos sobre la base de datos. Sigue los pasos de "Cambiar contraseña" y "Añadir usuario a base de datos" que vimos arriba.

P: Mi hosting usa Syspanel, ¿cómo accedo a las bases de datos?
R: Si tu proveedor usa Syspanel, recuerda que el acceso es por el puerto 2106. Dentro de Syspanel, busca la sección "Bases de Datos" en el menú lateral. La interfaz es muy similar a la de Plesk, con un gestor de bases de datos integrado.

P: ¿Qué significa el error "Too many connections"?
R: Significa que tu servidor MySQL ha alcanzado el límite máximo de conexiones simultáneas. Esto suele pasar en webs con mucho tráfico o con plugins mal optimizados. La solución temporal es reiniciar MySQL, pero la definitiva es optimizar las consultas de tu web o aumentar el límite en my.cnf.

Conclusión

El error "Can't connect to local MySQL server" puede ser frustrante, pero como has visto, casi siempre tiene una solución lógica y accesible. La clave es ir paso a paso: primero reiniciar el servicio, luego verificar las credenciales y, por último, revisar la configuración avanzada del servidor.

Si has seguido todos los pasos de esta guía para solucionar conexión mysql y el problema persiste, te recomendamos encarecidamente que contactes con tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar problemas de hardware o red que están fuera de tu alcance. No te sientas mal por no poder arreglarlo; a veces, el problema está en el hardware del servidor o en un ataque DDoS que satura el sistema.

Esperamos que esta guía extensa te haya sido de gran ayuda. Recuerda que la paciencia y el método son tus mejores aliados en el mundo del hosting. ¡Mucha suerte!