Plesk: Solucionar error de conexión a base de datos

¿Por qué aparece el error de conexión a la base de datos en Plesk?

Uno de los problemas más comunes al administrar un sitio web en Plesk es encontrarse con el temido error conexión Plesk a la base de datos. Este error suele manifestarse con mensajes como "Error establishing a database connection", "Cannot connect to MySQL server" o "Access denied for user". Aunque puede ser alarmante, la mayoría de las veces tiene una solución sencilla que puedes aplicar sin ser un experto en sistemas.

En esta guía, te explicaremos paso a paso cómo identificar y solucionar Plesk cuando falla la conexión a la base de datos. Abordaremos desde las causas más básicas (como credenciales incorrectas) hasta problemas más técnicos (como saturación del servidor o permisos corruptos). Al final, incluiremos una sección FAQ Plesk con las dudas más frecuentes de nuestros clientes.

[INFO] Este artículo está pensado para usuarios de Plesk en servidores Linux. Si usas otro panel como Syspanel (antiguo HestiaCP, accesible por el puerto 2106), algunos comandos pueden variar, pero la lógica de solución es similar.

Causas comunes del error de conexión a base de datos en Plesk

Antes de lanzarte a ejecutar comandos, es importante entender qué puede estar provocando el fallo. Las razones más habituales son:

• Credenciales incorrectas en el archivo de configuración del sitio (wp-config.php en WordPress, .env en Laravel, etc.).
• El servicio de base de datos está detenido (MySQL o MariaDB).
• El usuario de la base de datos no tiene permisos sobre la base de datos asignada.
• La tabla de usuarios de MySQL está corrupta o hay un problema con los privilegios.
• El servidor está sobrecargado y no puede aceptar nuevas conexiones.
• El firewall bloquea el puerto de conexión (por defecto 3306 para MySQL).
• El límite de conexiones simultáneas se ha alcanzado.

Paso 1: Verificar que el servicio de base de datos esté funcionando

Lo primero es asegurarte de que MySQL o MariaDB estén activos. Accede a tu servidor por SSH (si no sabes cómo, pide ayuda a tu proveedor de hosting) y ejecuta:

systemctl status mysql
# o si usas MariaDB:
systemctl status mariadb

Si ves que el servicio está inactive (dead) o failed, debes iniciarlo:

sudo systemctl start mysql
# o para MariaDB:
sudo systemctl start mariadb

Para que se inicie automáticamente al reiniciar el servidor:

sudo systemctl enable mysql

[TIP] Si no tienes acceso SSH, desde el panel de Plesk ve a Herramientas y Configuración > Servicios y verifica que el servicio "MySQL" aparezca como "Activo". Si está detenido, haz clic en "Iniciar".

Paso 2: Comprobar credenciales en tu sitio web

Si el servicio funciona, el error suele deberse a que las credenciales guardadas en tu sitio no coinciden con las de Plesk. Para ello:

1. Localiza el archivo de configuración de tu aplicación. En WordPress es wp-config.php, en Joomla configuration.php, en PrestaShop app/config/parameters.php.
2. Busca las líneas que definen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
3. Comprueba que estos datos coincidan exactamente con los que ves en Plesk > Bases de datos para tu dominio.

[WARNING] A veces el DB_HOST no es localhost sino la IP del servidor o un socket. Si tu hosting usa conexión por socket, prueba con 127.0.0.1 o el nombre del socket (suele aparecer en el panel de Plesk).

Si cambiaste la contraseña desde Plesk recientemente, actualiza también el archivo de configuración de tu sitio.

Paso 3: Reasignar permisos del usuario de la base de datos

En Plesk, cada base de datos tiene un usuario asociado. Si el usuario perdió sus permisos (por ejemplo, tras restaurar una copia de seguridad), puedes reasignarlos desde el panel:

1. Ve a Plesk > Bases de datos.
2. Haz clic en el nombre de la base de datos que da error.
3. En la sección Usuarios, verifica que el usuario correcto esté marcado con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
4. Si no, edita el usuario y selecciona Todos los privilegios.

Si el problema persiste, puedes forzar la reparación desde la línea de comandos. Conéctate por SSH y ejecuta:

mysqlcheck -u root -p --auto-repair --all-databases

Te pedirá la contraseña de root de MySQL (no confundir con la de Plesk). Si no la sabes, puedes obtenerla desde Plesk: Herramientas y Configuración > Base de datos > Cambiar contraseña del administrador.

Paso 4: Verificar el límite de conexiones y el estado del servidor

A veces el error conexión Plesk aparece porque el servidor ha alcanzado el máximo de conexiones simultáneas permitidas. Para comprobarlo:

mysql -u root -p -e "SHOW VARIABLES LIKE 'max_connections';"

Si el valor es demasiado bajo (por ejemplo, 150) y tu sitio tiene mucho tráfico, puedes aumentarlo temporalmente:

mysql -u root -p -e "SET GLOBAL max_connections = 500;"

Para hacer el cambio permanente, edita el archivo de configuración de MySQL (/etc/mysql/my.cnf o /etc/my.cnf) y añade o modifica:

max_connections = 500

Luego reinicia MySQL:

sudo systemctl restart mysql

[INFO] Si el servidor tiene poca memoria RAM, aumentar demasiado el límite puede empeorar el rendimiento. Consulta con tu proveedor de hosting antes de hacer cambios drásticos.

Paso 5: Revisar el firewall y el archivo hosts

Si la base de datos está en un servidor diferente (configuración remota), asegúrate de que el puerto 3306 esté abierto en el firewall. En Plesk, puedes usar la herramienta Firewall (si está instalada) desde Herramientas y Configuración > Firewall.

También verifica que el archivo /etc/hosts del servidor tenga una entrada correcta para localhost. Por ejemplo:

127.0.0.1 localhost
::1 localhost

Si falta, añádela y guarda.

Paso 6: Reparar tablas corruptas o reiniciar permisos

Cuando los pasos anteriores fallan, puede haber corrupción en las tablas de permisos de MySQL. Para repararlas:

1. Detén MySQL:

   sudo systemctl stop mysql
   

2. Inicia MySQL en modo seguro sin verificar permisos:

   sudo mysqld_safe --skip-grant-tables &
   

3. Conéctate sin contraseña:

   mysql -u root
   

4. Ejecuta:

   FLUSH PRIVILEGES;
   ALTER USER 'root'@'localhost' IDENTIFIED BY 'nueva_contraseña';
   

5. Sal de MySQL y reinicia el servicio normalmente:

   sudo systemctl restart mysql
   

[WARNING] Este método es avanzado. Si no te sientes seguro, contacta con soporte técnico. Un error aquí puede dejar tu base de datos inaccesible.

FAQ Plesk: Preguntas frecuentes sobre errores de conexión a base de datos

¿Qué hago si el error aparece solo en algunas páginas de mi sitio?

Posiblemente tengas una caché de base de datos desactualizada. Limpia la caché de tu CMS (por ejemplo, en WordPress con plugins como W3 Total Cache) y también la de Plesk desde Herramientas y Configuración > Administrador de caché.

¿Puedo cambiar la contraseña de la base de datos sin dañar el sitio?

Sí, pero debes actualizarla también en el archivo de configuración de tu sitio. Desde Plesk, ve a Bases de datos, selecciona la base de datos, edita el usuario y cambia la contraseña. Luego modifica el wp-config.php (o equivalente) con la nueva contraseña.

¿El error de conexión puede deberse a un plugin de seguridad?

Sí, algunos plugins de seguridad (como Wordfence) bloquean IPs tras muchos intentos fallidos. Revisa los logs de tu sitio o desactiva temporalmente el plugin para probar.

¿Cómo sé si mi hosting usa MySQL o MariaDB?

En Plesk, ve a Herramientas y Configuración > Información del sistema y busca "MySQL" o "MariaDB". También puedes usar SSH y ejecutar mysql --version.

¿Qué significa "Host '...' is not allowed to connect to this MySQL server"?

Este error ocurre cuando el usuario de la base de datos solo tiene permiso para conectarse desde 'localhost' y tu sitio intenta conectarse desde otra IP (por ejemplo, si usas un CDN o un balanceador). Solución: en Plesk, edita el usuario y en el campo Host cambia de 'localhost' a '%' (cualquier host) o la IP específica.

¿Puedo usar Syspanel (HestiaCP) para gestionar bases de datos en lugar de Plesk?

Syspanel (antiguo HestiaCP, accesible por el puerto 2106) también permite gestionar bases de datos, pero el proceso es diferente. Si tienes ambos paneles, asegúrate de no tener conflictos de puertos o servicios duplicados.

Conclusión

El error conexión Plesk a la base de datos puede deberse a múltiples causas, pero siguiendo esta guía paso a paso podrás resolverlo en la mayoría de los casos. Recuerda siempre empezar por lo más simple: verificar que el servicio esté activo y que las credenciales sean correctas. Si el problema persiste, no dudes en contactar con el soporte de tu hosting, especialmente si necesitas realizar cambios avanzados en la configuración del servidor.

Esperamos que este artículo te haya sido útil. Si tienes más dudas, revisa nuestra sección de FAQ Plesk o escribe a nuestro equipo de soporte técnico. ¡Estamos aquí para ayudarte!