Errores de conexión a base de datos en WordPress Plesk: Soluciones

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

El mensaje «Error de conexión a la base de datos» es uno de los más temidos por cualquier usuario de WordPress. Si ves esta pantalla en tu sitio, no entres en pánico. Es un problema común y, en la mayoría de los casos, tiene solución rápida. Este error indica que WordPress no puede comunicarse con la base de datos donde se almacenan tus contenidos, usuarios y configuraciones. En un entorno con Plesk, las causas suelen ser sencillas de identificar y corregir.

Vamos a desglosar paso a paso cómo solucionarlo, desde lo más básico hasta opciones más avanzadas, siempre pensando en que cualquier persona, aunque no sea experta, pueda seguirlo.

Causas más comunes del error

Antes de lanzarnos a soluciones, entender por qué ocurre te ayudará a prevenirlo en el futuro. Las razones principales son:

Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor no coinciden con los que WordPress espera.
Base de datos corrupta o dañada: A veces, una tabla de la base de datos se rompe y WordPress no puede leer la información.
Servidor de base de datos caído o sobrecargado: El servicio MySQL o MariaDB (los motores de base de datos) puede estar detenido o tener problemas.
Archivo wp-config.php dañado: Este archivo es el «mapa» que conecta WordPress con la base de datos. Si está mal escrito o tiene errores, la conexión falla.
Problemas de permisos: El usuario de la base de datos puede no tener los permisos necesarios para acceder a ella.
Actualizaciones o cambios recientes: Una actualización de WordPress, un plugin o un cambio en el panel de Plesk pueden desconfigurar la conexión.

Soluciones paso a paso

A continuación, te presento una guía ordenada para que vayas probando cada solución. Empieza por la primera y avanza solo si el error persiste.

1. Verifica el estado del servicio de base de datos en Plesk

Lo primero es asegurarte de que el servidor de bases de datos esté funcionando. Plesk tiene su propio gestor de servicios.

Pasos:

Inicia sesión en tu panel de Plesk (normalmente es https://tudominio.com:8443 o la dirección que te haya dado tu proveedor).
Ve a Herramientas y Configuración (en la barra lateral izquierda).
Busca la sección Servicios y haz clic en Administrador de servicios.
Localiza el servicio llamado MySQL o MariaDB. Debería aparecer como Activo o Running.
Si está detenido, selecciona la casilla junto a él y haz clic en el botón Iniciar (el icono de play).
Si ya está activo, pero el error persiste, puedes probar a Reiniciar el servicio (icono de reciclaje) para refrescar la conexión.

[TIP]: Si no encuentras el Administrador de servicios, busca en la barra de búsqueda de Plesk «Servicios» y te llevará directamente.

2. Comprueba las credenciales en el archivo wp-config.php

Este archivo es el corazón de la conexión. Un error tipográfico aquí es la causa más frecuente del problema.

Pasos:

Accede a los archivos de tu sitio web. Puedes hacerlo desde el Administrador de archivos de Plesk (en el panel de tu dominio, busca la sección «Archivos» o «File Manager») o mediante FTP.
Busca el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en la carpeta httpdocs o public_html).
Ábrelo con un editor de texto (como el Bloc de notas o el editor integrado de Plesk).

Busca las siguientes líneas (al principio del archivo):

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario_de_base_de_datos');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Verifica que cada valor sea exactamente el correcto. Los datos los puedes encontrar en Plesk:
- Ve a Bases de datos en el panel de tu dominio.
- Ahí verás listadas tus bases de datos. Al hacer clic en una, verás el nombre, el usuario y el servidor (normalmente localhost).
- Si no recuerdas la contraseña, puedes cambiarla desde el mismo panel: selecciona la base de datos, ve a «Cambiar contraseña» y asígnale una nueva.
Importante: Asegúrate de que no haya espacios en blanco alrededor de las comillas o al final de las líneas. El formato debe ser exacto.

[WARNING]: No utilices editores de texto como Word o Pages, ya que pueden añadir caracteres ocultos que rompen el archivo. Usa editores de texto plano como el Bloc de notas, Sublime Text o Visual Studio Code.

3. Verifica el servidor de la base de datos (DB_HOST)

Aunque normalmente es localhost, a veces tu proveedor de hosting usa un servidor diferente. Esto es común en hosting compartidos o en configuraciones con Plesk más complejas.

Pasos:

En el mismo archivo wp-config.php, localiza la línea define('DB_HOST', 'localhost');.
Cambia localhost por la dirección que te haya proporcionado tu proveedor. Puede ser algo como mysql.tudominio.com o una IP.
Si no estás seguro, contacta con el soporte de tu hosting. También puedes probar con 127.0.0.1 (la dirección IP de localhost) o, en algunos casos, con localhost:3306 (especificando el puerto).

[INFO]: Si tu sitio usa una base de datos externa (por ejemplo, gestionada en otro servidor), el DB_HOST será la IP o el nombre de dominio de ese servidor.

4. Repara la base de datos desde Plesk

A veces, la base de datos se corrompe ligeramente. Plesk permite repararla fácilmente.

Pasos:

Ve a Bases de datos en el panel de tu dominio.
Haz clic en el nombre de la base de datos que usa tu WordPress.
Busca un botón o enlace que diga Reparar o Check & Repair. En algunas versiones de Plesk, está en la sección de «Herramientas» o al hacer clic en el nombre de la base de datos.
Plesk ejecutará una comprobación y reparará las tablas dañadas automáticamente.
Una vez terminado, vuelve a cargar tu web.

[TIP]: Si no ves la opción de reparar, puedes hacerlo manualmente desde phpMyAdmin (accesible desde el panel de Plesk, en la misma sección de Bases de datos). Selecciona todas las tablas y elige «Reparar tabla» en el menú desplegable.

5. Revisa los permisos del usuario de la base de datos

El usuario que utiliza WordPress debe tener todos los permisos necesarios sobre la base de datos.

Pasos:

En Plesk, ve a Bases de datos y haz clic en el nombre de tu base de datos.
Busca la sección de Usuarios o Permisos.
Asegúrate de que el usuario asociado tenga marcados los permisos ALL PRIVILEGES (todos los privilegios). Si no es así, selecciona la opción «Otorgar todos los privilegios» o marca manualmente todas las casillas.
Guarda los cambios.

6. Limpia la caché de tu navegador y del servidor

A veces, el navegador o una caché del servidor guardan una versión antigua del error.

Pasos:

Limpia la caché de tu navegador (en Chrome: Configuración > Privacidad y seguridad > Borrar datos de navegación).
Si tu sitio usa algún plugin de caché (como WP Rocket o W3 Total Cache), accede a tu panel de administración de WordPress (si puedes) o, si no, borra manualmente la carpeta de caché desde el Administrador de archivos de Plesk (suele estar en /wp-content/cache/).
En Plesk, también puedes limpiar la caché del servidor web desde Herramientas y Configuración > Administrador de servicios > Reiniciar el servicio de Apache o Nginx.

7. Comprueba si hay conflictos con plugins o temas

Si el error apareció después de instalar o actualizar un plugin o tema, puede que esté causando un conflicto.

Pasos:

Accede a los archivos de tu sitio por FTP o Administrador de archivos.
Ve a la carpeta /wp-content/plugins/.
Renombra la carpeta completa a plugins_old (o algo similar). Esto desactivará todos los plugins.
Vuelve a cargar tu web. Si el error desaparece, el problema es un plugin. Reactívalos de uno en uno (desde el panel de WordPress, renombrando la carpeta de nuevo a plugins) para identificar al culpable.
Si el error persiste, prueba con el tema. Renombra la carpeta del tema activo en /wp-content/themes/ (por ejemplo, tu-tema-activo_old). WordPress usará un tema por defecto (como Twenty Twenty-Four) y debería funcionar.

8. Revisa los logs de error en Plesk

Los registros de error son tus mejores aliados para diagnósticos más profundos.

Pasos:

En el panel de tu dominio en Plesk, busca la sección Registros o Logs.
Abre el archivo error_log (o similar) de tu sitio web.
Busca entradas recientes relacionadas con la base de datos (por ejemplo, «Error establishing a database connection» o «Access denied for user»).
El mensaje de error te dará pistas precisas: si dice «Unknown database», el nombre de la base de datos en wp-config.php es incorrecto; si dice «Access denied», el usuario o contraseña son erróneos.

Preguntas frecuentes (FAQ)

¿Qué hago si después de todo el error sigue apareciendo?

Si has seguido todos los pasos y el error persiste, el problema puede estar en el servidor mismo. Contacta con tu proveedor de hosting y explícales que ya has verificado credenciales, permisos y el estado del servicio. Ellos podrán revisar los logs del servidor de base de datos a nivel raíz.

¿Puedo evitar este error en el futuro?

Sí, con estas buenas prácticas:

Realiza copias de seguridad periódicas de tu base de datos desde Plesk (en la sección de Bases de datos, suele haber una opción de «Exportar» o «Backup»).
Actualiza WordPress, plugins y temas con cuidado. Siempre haz un backup antes de actualizar.
No modifiques el archivo wp-config.php a menos que sepas exactamente qué estás haciendo.
Usa contraseñas seguras para la base de datos y cámbialas periódicamente.

¿El error puede deberse a un ataque?

Es posible. Si sospechas de un ataque, escanea tu sitio con un plugin de seguridad (como Wordfence) y cambia todas las contraseñas (de WordPress, de la base de datos, de FTP y de Plesk). Además, revisa los usuarios de la base de datos en Plesk para asegurarte de que no haya usuarios extraños.

¿Y si uso Syspanel (HestiaCP)?

Si tu panel es Syspanel (HestiaCP), el proceso es similar, pero el acceso es por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, busca la sección Bases de datos para gestionar usuarios, contraseñas y permisos. El archivo wp-config.php se modifica exactamente igual.

Conclusión

El error de conexión a la base de datos en WordPress con Plesk es frustrante, pero casi siempre tiene una solución sencilla. Siguiendo esta guía paso a paso, podrás identificar y corregir el problema en la mayoría de los casos. Recuerda: empieza por lo básico (credenciales y estado del servicio) y ve avanzando hacia soluciones más específicas. Si nada funciona, no dudes en pedir ayuda a tu proveedor de hosting. ¡Tu sitio web volverá a estar en línea en poco tiempo!