Error de conexión base de datos Plesk – Soluciones

¡Tranquilo! Es frustrante encontrarse con un error conexión base de datos Plesk, sobre todo si tu web se ha vuelto invisible de repente. Pero no te preocupes, este problema es muy común y casi siempre tiene solución. En esta guía extensa y detallada, te voy a explicar paso a paso qué hacer cuando Plesk no conecta MySQL o cuando tu gestor de contenidos (como WordPress) te muestra el temido mensaje de "Error al establecer conexión con la base de datos".

Vamos a ir desde lo más sencillo hasta lo más técnico, pero siempre con un lenguaje claro y ejemplos prácticos. ¡Manos a la obra!

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

Antes de lanzarnos a arreglarlo, es útil entender por qué ocurre. Las causas más frecuentes son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos en tu archivo de configuración (por ejemplo, en wp-config.php de WordPress).
Servicio MySQL/MariaDB detenido: El propio motor de base de datos se ha parado por un error del sistema, una actualización o falta de recursos.
Permisos de usuario revocados: El usuario de la base de datos ha perdido los permisos para acceder a ella desde un host específico (normalmente localhost).
Configuración de red o firewall: Un cambio en la configuración de red del servidor o un bloqueo del firewall impide que la aplicación web se comunique con la base de datos.
Corrupción de tablas: A veces, una tabla de la base de datos se daña y provoca que la conexión falle.
Límite de conexiones alcanzado: El servidor tiene un número máximo de conexiones simultáneas y se ha agotado.

Paso 1: Lo primero, verifica el estado del servicio MySQL/MariaDB

Este es el paso más básico y rápido. Si el servicio no está corriendo, nada funcionará.

¿Cómo verificarlo desde Plesk?

Inicia sesión en tu panel de Plesk.
Ve a Herramientas y Configuración (en el menú de la izquierda, a veces está abajo del todo).
Busca la sección Servidor y haz clic en Servicios del Sistema.
Busca en la lista el servicio MySQL o MariaDB (depende de lo que tengas instalado).
Verifica que el estado sea "Activo" o "En ejecución". Si ves un círculo rojo o un estado como "Detenido", tienes el primer problema.

¿Cómo solucionarlo si está detenido?

Si ves el servicio detenido, simplemente haz clic en el botón "Iniciar" (un triángulo verde) que está a su lado.
Si no se inicia, probablemente haya un error más profundo. En ese caso, necesitarás acceder al servidor por SSH (línea de comandos) o contactar a tu proveedor de hosting.

[WARNING] Si el servicio se detiene solo y no puedes iniciarlo, o se vuelve a detener a los pocos segundos, contacta con tu soporte técnico. Podría ser un problema de memoria, un disco lleno o una corrupción grave del sistema.

Paso 2: Revisa las credenciales de la base de datos (el error más común)

Si el servicio funciona, el siguiente paso es asegurarte de que tu aplicación (WordPress, Joomla, etc.) tiene los datos de acceso correctos. Un simple cambio de contraseña o un error al escribir el nombre de la base de datos es la causa número uno del WordPress error base de datos.

¿Dónde están las credenciales en WordPress?

Accede a tu panel de Plesk.
Ve a Sitios web y dominios.
Busca el dominio de tu sitio web y haz clic en Administrador de archivos.
Navega hasta la carpeta raíz de tu sitio (normalmente httpdocs o public_html).
Busca el archivo wp-config.php y haz clic derecho sobre él para seleccionar "Editar en el editor de texto" (o descárgalo y edítalo con un editor como Notepad++).

Dentro del archivo, busca estas líneas (son las líneas que empiezan con define):

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'nombre_de_tu_usuario');
define('DB_PASSWORD', 'tu_contraseña_secreta');
define('DB_HOST', 'localhost'); // A veces puede ser una IP o un socket

¿Cómo comprobar que son correctas?

Vuelve a Plesk y ve a Bases de datos (en el menú de la izquierda).
Ahí verás una lista de todas tus bases de datos. Busca la que coincida con el DB_NAME de tu archivo.
Haz clic en el nombre de la base de datos. Se abrirá una ventana con los detalles.
Ahí verás el nombre de la base de datos, el nombre de usuario asociado y la opción de "Cambiar contraseña".
Compara estos datos exactamente con los que tienes en el wp-config.php. ¡Incluso un espacio extra o una mayúscula mal puesta puede romper la conexión!

[TIP] Si sospechas que la contraseña es incorrecta, la forma más segura es cambiarla desde Plesk (en la ventana de detalles de la base de datos) y luego actualizar la contraseña en tu wp-config.php con la nueva. Así te aseguras de que coinciden.

Paso 3: Verifica los permisos del usuario de la base de datos

A veces, el usuario existe y la contraseña es correcta, pero no tiene permiso para conectarse desde el lugar donde está tu web (normalmente localhost).

Cómo revisar y otorgar permisos en Plesk

Ve a Bases de datos en el panel de Plesk.
Haz clic en el nombre de tu base de datos problemática.
En la ventana que se abre, busca la sección "Usuarios de base de datos".
Verás una tabla con los usuarios. Junto a cada usuario, hay una columna llamada "Acceso desde" o "Host".
Debe aparecer localhost (o 127.0.0.1). Si aparece % (cualquier host) también funciona, pero localhost es lo más común y seguro.
Si no ves el usuario, o ves que el host es diferente, deberás añadirlo o modificarlo. Plesk suele gestionar esto automáticamente, pero a veces falla.

[INFO] Si no te sientes cómodo editando permisos desde Plesk, la opción más segura es eliminar el usuario problemático y crear uno nuevo desde la misma interfaz de la base de datos, asignándosela a ella. Luego, actualiza las credenciales en tu wp-config.php.

Paso 4: Comprueba el archivo de configuración de Plesk (para usuarios avanzados)

Si los pasos anteriores no funcionan, el problema podría estar en la configuración interna de Plesk o del servidor. Esto es menos común, pero merece la pena revisarlo.

Revisar el archivo `db_connect.php` (si lo usas)

Algunas aplicaciones no usan wp-config.php sino un archivo personalizado. Busca en tu carpeta raíz archivos como db_connect.php, config.php o database.php y revisa las credenciales dentro.

Problemas con el socket de MySQL

En ocasiones, el host de la base de datos no es localhost sino una ruta a un socket, como /var/run/mysqld/mysqld.sock. Esto es más técnico, pero puedes probar a cambiarlo en tu archivo de configuración. Si tu hosting usa Plesk, el valor casi siempre es localhost.

Paso 5: Repara las tablas de la base de datos (si está corrupta)

Una base de datos corrupta puede dar errores de conexión o hacer que tu web cargue en blanco.

Cómo reparar desde phpMyAdmin (incluido en Plesk)

En el panel de Plesk, ve a Bases de datos.
Haz clic en el nombre de la base de datos.
Busca el enlace o botón que dice "phpMyAdmin" (suele estar en la parte superior derecha o en la sección de herramientas). Se abrirá una nueva pestaña.
En phpMyAdmin, a la izquierda verás una lista de tablas de tu base de datos.
Selecciona todas las tablas (marca la casilla de arriba del todo).
En el menú desplegable que dice "Con seleccionadas:" (o similar), elige "Reparar tabla".
phpMyAdmin ejecutará el comando REPAIR TABLE y te mostrará el resultado. Si alguna tabla no se puede reparar, te lo indicará.

[WARNING] Si la reparación falla, no desesperes. A veces hay que restaurar desde una copia de seguridad. Pero primero, intenta reparar de nuevo o contacta a tu soporte.

Paso 6: Soluciones rápidas para WordPress (FAQ)

Aquí tienes una lista de acciones rápidas que puedes probar si el WordPress error base de datos persiste:

Desactiva todos los plugins: A veces un plugin conflictivo puede causar este error. Si no puedes acceder al panel de administración, renombra la carpeta wp-content/plugins a wp-content/plugins_old desde el Administrador de archivos de Plesk. Esto desactivará todos los plugins y, si funciona, sabrás que uno de ellos era el culpable.
Cambia a un tema por defecto: Similar a los plugins, renombra la carpeta de tu tema activo (dentro de wp-content/themes) para forzar a WordPress a usar un tema por defecto (Twenty Twenty-Four, etc.).
Aumenta el límite de memoria de WordPress: Añade esta línea a tu wp-config.php, justo antes de la línea que dice /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```
Verifica la dirección del sitio: En tu wp-config.php, asegúrate de que las líneas WP_HOME y WP_SITEURL (si existen) tengan la URL correcta. Si no están, no pasa nada, WordPress usa la que tiene por defecto.

¿Qué pasa si nada de esto funciona?

Si has llegado hasta aquí y el error conexión base de datos Plesk sigue apareciendo, entonces el problema es más complejo y probablemente requiere acceso al servidor a nivel de sistema operativo. En ese caso:

Contacta a tu proveedor de hosting. Ellos tienen acceso completo al servidor y pueden revisar los logs de MySQL (errores internos), la configuración de red, el firewall y otros aspectos que tú no puedes ver desde Plesk.
Restaura desde una copia de seguridad. Esta es tu red de seguridad. Si tienes una copia de seguridad reciente de tu sitio y tu base de datos (Plesk suele hacerlas automáticamente), puedes restaurarla. Ve a Sitios web y dominios > tu dominio > Copias de seguridad y sigue las instrucciones.

Consejos finales para evitar futuros problemas

Cambia las contraseñas con cuidado: Siempre que cambies la contraseña de tu base de datos, actualízala inmediatamente en el archivo de configuración de tu web.
Mantén todo actualizado: Tanto Plesk como tu CMS (WordPress, etc.) y sus plugins/temas deben estar en su última versión para evitar bugs y vulnerabilidades.
Haz copias de seguridad periódicas: No confíes solo en las copias automáticas. Descarga una copia de tu base de datos y archivos cada cierto tiempo.
Anota todo: Guarda en un lugar seguro los nombres de tus bases de datos, usuarios y contraseñas. Te ahorrará muchos quebraderos de cabeza.

[INFO] Si en algún momento migras tu web a un panel como Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso a ese panel es el 2106. La gestión de bases de datos es similar, pero la interfaz cambia ligeramente. Siempre que tengas dudas, busca la sección de "Bases de Datos" en tu panel.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Sigue los pasos en orden y, si te atascas, no dudes en pedir ayuda a tu proveedor de hosting. ¡Tu web volverá a estar online en poco tiempo!