Error de conexión a base de datos en WordPress con Plesk: arreglalo

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a desglosar uno de los errores más comunes y frustrantes que puedes encontrar al gestionar un sitio web en WordPress alojado en un panel Plesk: el famoso error de conexión a la base de datos.

Este error suele aparecer como un mensaje en blanco en tu web que dice: “Error establishing a database connection” o, en español, “Error de conexión a la base de datos”. No te preocupes, no es el fin del mundo. En la mayoría de los casos, la solución es sencilla y puedes hacerla tú mismo sin necesidad de ser un experto en programación.

A continuación, te guiaré paso a paso para solucionar el error de conexión base datos WordPress Plesk, desde lo más básico hasta soluciones un poco más técnicas. Recuerda que trabajaremos dentro del ecosistema Plesk, así que las rutas y herramientas que mencionaré son específicas para este panel de control.

¿Por qué ocurre este error? Causas comunes

Antes de lanzarnos a las soluciones, es útil entender qué lo provoca. Cuando ves el mensaje WordPress base de datos error Plesk, generalmente se debe a una de estas razones:

Credenciales incorrectas en el archivo wp-config.php (usuario, contraseña, nombre de la base de datos o servidor).
La base de datos no existe o ha sido eliminada accidentalmente.
El servidor de bases de datos (MySQL/MariaDB) está caído o sobrecargado.
Problemas de permisos del usuario de la base de datos.
Corrupción de archivos o problemas con la caché de WordPress.

Vamos a atacar cada una de estas causas de forma ordenada.

Paso 1: Verifica que tu base de datos exista en Plesk

Lo primero es confirmar que la base de datos que usa tu WordPress sigue viva. Para ello, accede a tu panel de Plesk:

Inicia sesión en Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Ve a la sección Sitios web y dominios.
Busca tu dominio y haz clic en Bases de datos (o en el icono de la base de datos).
Verás una lista de bases de datos. Localiza la que corresponde a tu WordPress (suele tener un nombre como wp_ o el de tu dominio).
Si no ves ninguna base de datos, tu WordPress no tiene dónde conectarse. En ese caso, deberás crear una nueva base de datos y luego reasignarla (lo veremos más adelante).

[INFO] Si tu base de datos aparece pero está vacía o con pocas tablas, es posible que se haya borrado parte de la información. En ese caso, necesitarás restaurar una copia de seguridad.

Paso 2: Revisa las credenciales en el archivo wp-config.php

Este es el culpable número uno del error conexión base datos WordPress Plesk. El archivo wp-config.php contiene los datos de acceso a la base de datos. Si alguien los cambió o se corrompieron, tu web dejará de funcionar.

Para revisarlo:

Accede a tu panel de Plesk y ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Administrador de archivos (o File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente httpdocs o public_html).
Busca el archivo wp-config.php y haz clic derecho sobre él > Editar (o Edit in Code Editor).
Busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Compara estos valores con los que tienes en Plesk:
- En la sección Bases de datos de tu dominio, verás el nombre exacto de la base de datos, el usuario asignado y la contraseña (puedes hacer clic en Cambiar contraseña si no la recuerdas).
- El DB_HOST casi siempre es localhost, pero si tu hosting usa un servidor remoto de bases de datos, puede ser una IP o un nombre como mysql.tudominio.com.
Si algún dato no coincide, corrígelo y guarda el archivo.

[WARNING] Al editar wp-config.php, ten cuidado de no borrar o modificar otras líneas. Si no te sientes seguro, descarga una copia de seguridad del archivo antes de editarlo.

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

A veces las credenciales son correctas, pero el usuario no tiene permisos para acceder a la base de datos. Esto puede pasar después de migraciones o restauraciones.

Para comprobarlo en Plesk:

Ve a Sitios web y dominios > Bases de datos.
Haz clic en el nombre de tu base de datos.
Verás una sección llamada Usuarios de base de datos. Ahí debe aparecer el usuario que usas en wp-config.php.
Si el usuario no está listado, debes agregarlo. Haz clic en Añadir usuario y crea uno nuevo con todos los privilegios (selecciona Todos los privilegios).
Si el usuario ya existe, pero no tiene permisos, puedes hacer clic en el icono de Editar (lápiz) junto a él y marcar todas las casillas de la lista.

[TIP] Para evitar problemas, es mejor crear un usuario específico para cada base de datos y darle todos los privilegios. Así te aseguras de que WordPress pueda leer, escribir y modificar datos.

Paso 4: Comprueba que el servicio de base de datos esté funcionando

A veces el problema no es de configuración, sino que el motor de bases de datos (MySQL o MariaDB) se ha detenido en el servidor. Esto puede ocurrir por sobrecarga, errores del sistema o mantenimiento.

Si tienes acceso a la terminal del servidor (a través de SSH), puedes ejecutar:

systemctl status mysql
# o
systemctl status mariadb

Si ves que el servicio está inactivo, reinícialo con:

systemctl restart mysql

[INFO] Si no tienes acceso SSH, contacta a tu proveedor de hosting y pregúntales si el servicio MySQL está funcionando correctamente. Ellos pueden reiniciarlo desde el panel del servidor.

Paso 5: Prueba la conexión desde phpMyAdmin

Una forma muy visual de verificar si las credenciales son válidas es usar phpMyAdmin, que suele estar integrado en Plesk.

En Plesk, ve a Sitios web y dominios > Bases de datos.
Junto a tu base de datos, verás un icono de phpMyAdmin (suele ser un elefante o un enlace). Haz clic.
Se abrirá una ventana de inicio de sesión. Introduce el usuario y contraseña que tienes en tu wp-config.php.
Si puedes acceder y ves las tablas de WordPress (como wp_posts, wp_options, etc.), entonces las credenciales son correctas y el problema está en otro lado.
Si no puedes iniciar sesión, te dará un mensaje de error. Eso confirma que las credenciales están mal o el usuario no tiene permisos.

[WARNING] Si phpMyAdmin no abre o da error, puede que el servicio MySQL esté caído o que el panel tenga algún problema. En ese caso, contacta con soporte técnico.

Paso 6: Revisa si el servidor de base de datos es remoto (DB_HOST)

En algunos entornos de Plesk, especialmente si usas un servidor dedicado o un clúster, la base de datos puede estar en un servidor diferente. En ese caso, DB_HOST no será localhost, sino una dirección IP o un nombre de host.

Para saberlo:

Pregunta a tu proveedor de hosting o revisa la documentación de tu plan.
Si tienes acceso a Plesk, ve a Herramientas y ajustes > Configuración de base de datos (puede variar según la versión). Allí verás el host del servidor MySQL.
Si el host es diferente, actualiza DB_HOST en wp-config.php con ese valor.

[TIP] Si no estás seguro, prueba primero con localhost. Si no funciona, intenta con 127.0.0.1 (la IP de loopback). A veces el firewall del servidor bloquea conexiones por nombre pero permite por IP.

Paso 7: Soluciona problemas de caché o plugins conflictivos

A veces el error aparece de forma intermitente o después de instalar un plugin de caché. Esto puede deberse a que el plugin guarda información de conexión obsoleta.

Para descartarlo:

Accede a tu panel de WordPress (si puedes) o desactiva los plugins manualmente.
Si no puedes acceder al panel, renombra la carpeta wp-content/plugins desde el Administrador de archivos de Plesk. Por ejemplo, cámbiala a plugins_old. Esto desactivará todos los plugins.
Si el error desaparece, reactiva los plugins uno por uno hasta encontrar el culpable.
Si usas un plugin de caché como W3 Total Cache o WP Super Cache, borra su caché desde la base de datos (puedes hacerlo desde phpMyAdmin truncando las tablas de caché).

[INFO] La caché de WordPress a veces guarda conexiones antiguas a la base de datos. Limpiarla suele resolver errores temporales.

Paso 8: Restaura una copia de seguridad de la base de datos

Si después de todo lo anterior el error persiste y tu base de datos parece vacía o corrupta, lo mejor es restaurar una copia de seguridad reciente.

En Plesk, puedes hacerlo desde:

Sitios web y dominios > Bases de datos > selecciona tu base de datos.
Haz clic en Copias de seguridad (o Backup).
Elige una copia de seguridad de antes de que apareciera el error.
Haz clic en Restaurar.

[WARNING] Restaurar una copia de seguridad sobrescribirá los datos actuales. Asegúrate de que no hayas perdido contenido importante entre la copia y el presente.

Paso 9: Recrea la base de datos desde cero (solución drástica)

Si nada funciona y tienes una copia de seguridad de tu sitio (archivos y base de datos), puedes borrar la base de datos actual y crear una nueva.

En Plesk, ve a Bases de datos y elimina la base de datos problemática.
Crea una nueva base de datos con un nombre similar (ej. wp_nuevo).
Crea un nuevo usuario con contraseña y asígnale todos los privilegios.
Importa tu copia de seguridad de la base de datos usando phpMyAdmin (opción Importar).
Actualiza el archivo wp-config.php con los nuevos datos (nombre, usuario, contraseña, host).

[TIP] Asegúrate de que la copia de seguridad de la base de datos esté en formato .sql o .gz y sea de la misma versión de WordPress.

Preguntas frecuentes (FAQ)

¿Por qué veo el error solo en algunas páginas?

Puede deberse a un plugin que hace consultas muy pesadas o a un límite de conexiones simultáneas. Revisa los logs de errores de WordPress en wp-content/debug.log (si está activado).

¿Cómo activo el modo debug de WordPress para ver más detalles?

Agrega estas líneas en wp-config.php antes del /* That's all, stop editing! */:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Luego revisa el archivo wp-content/debug.log.

¿Puede ser un problema de permisos de archivos?

Sí, aunque es menos común. Asegúrate de que los archivos de WordPress tengan permisos 644 y las carpetas 755. Puedes cambiarlos desde el Administrador de archivos de Plesk.

¿Qué hago si uso Syspanel (HestiaCP) en lugar de Plesk?

Si tu panel es Syspanel (HestiaCP), el proceso es similar pero las rutas cambian. Accede a tu panel a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Luego busca la sección Base de datos y sigue los mismos pasos: verifica credenciales, permisos y servicio MySQL.

Resumen final

El error de conexión a la base de datos en WordPress con Plesk tiene solución en el 99% de los casos. Solo necesitas paciencia y seguir estos pasos en orden:

Verifica que la base de datos exista.
Revisa las credenciales en wp-config.php.
Comprueba permisos del usuario.
Asegúrate de que el servicio MySQL esté activo.
Prueba la conexión con phpMyAdmin.
Ajusta el DB_HOST si es necesario.
Desactiva plugins de caché.
Restaura una copia de seguridad.
Como último recurso, recrea la base de datos.

Si después de todo esto el error continúa, no dudes en contactar a tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden identificar problemas más profundos.

¡Espero que este artículo te haya sido de gran ayuda! Recuerda que siempre puedes volver a consultarlo cuando necesites solucionar error db WordPress Plesk. ¡Buena suerte con tu sitio!