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

¿Te has encontrado con el temido mensaje "Error establishing a database connection" en tu sitio WordPress alojado en un servidor con Plesk? No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. Esta guía paso a paso te ayudará a diagnosticar y resolver el error conexión base datos en WordPress cuando usas Plesk, de forma clara y sin tecnicismos innecesarios.

¿Qué significa este error y por qué ocurre?

El mensaje "Error establishing a database connection" (o "Error de conexión a la base de datos") aparece cuando WordPress intenta comunicarse con la base de datos MySQL o MariaDB donde se almacena todo tu contenido (posts, páginas, usuarios, configuraciones) y no lo consigue. Es como si tu web quisiera abrir un archivador pero la llave no gira o el archivador está cerrado con llave.

Las causas más habituales son:

Credenciales incorrectas en el archivo wp-config.php.
Base de datos o usuario eliminados por error.
Servidor de bases de datos caído o sobrecargado.
Problemas de permisos del usuario de la base de datos.
Corrupción de la base de datos (raro, pero posible).
Cambios en la configuración del hosting (por ejemplo, al migrar de servidor).

En un entorno Plesk, la gestión de bases de datos se hace desde su panel. Vamos a revisar cada punto.

Paso 1: Verifica que el servidor de bases de datos esté funcionando

Antes de tocar nada, asegúrate de que el servicio MySQL/MariaDB esté activo. Si el servidor está caído, ningún sitio funcionará.

En Plesk (panel de administración del servidor)

Accede a Plesk como administrador (normalmente en https://tudominio.com:8443).
Ve a Herramientas y ajustes > Administración de servicios.
Busca el servicio MySQL o MariaDB. Debe aparecer como "En ejecución".
Si está detenido, haz clic en el botón de inicio (triángulo verde). Si no se inicia, contacta con tu proveedor de hosting.

[WARNING] Si no tienes acceso de administrador a Plesk, contacta con el soporte de tu hosting. Ellos pueden reiniciar el servicio.

Si usas Syspanel (HestiaCP)

Si tu panel es Syspanel (el nuevo nombre de HestiaCP), accede por el puerto 2106 (https://tudominio.com:2106). Ve a Servicios y verifica que mysql esté marcado como "running".

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

El archivo wp-config.php contiene el nombre de la base de datos, el usuario, la contraseña y el servidor. Un error tipográfico aquí es la causa más frecuente del error conexión base datos.

Localiza el archivo

Conéctate a tu hosting por FTP (FileZilla, por ejemplo) o usa el Administrador de archivos de Plesk.
En la raíz de tu sitio WordPress (donde están carpetas como wp-content, wp-admin), busca el archivo wp-config.php.

Edita las líneas clave

Abre el archivo con un editor de texto (Bloc de notas, Sublime Text, etc.) y busca estas líneas:

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

Verifica:

DB_NAME: Debe coincidir exactamente con el nombre que ves en Plesk (mayúsculas/minúsculas cuentan).
DB_USER: Igual, debe ser el usuario asignado a esa base de datos.
DB_PASSWORD: La contraseña correcta. Si la cambiaste, actualízala aquí.
DB_HOST: Casi siempre es localhost. Si tu hosting usa un servidor separado, puede ser algo como mysql.tudominio.com. Pregunta a tu proveedor.

[TIP] Si no recuerdas la contraseña, en Plesk puedes cambiarla desde la sección de bases de datos. Luego actualiza wp-config.php con la nueva.

Cómo obtener los datos correctos desde Plesk

En Plesk, ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Bases de datos.
Verás una lista con las bases de datos de ese sitio. Haz clic en el nombre de la que usa WordPress.
Allí verás el nombre de la base de datos, el usuario y un enlace para cambiar la contraseña.

Copia esos valores exactamente en tu wp-config.php. Guarda el archivo y vuelve a cargar tu web.

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

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos.

En Plesk

Ve a Bases de datos dentro de tu dominio.
Haz clic en el nombre de la base de datos.
Busca la sección Usuarios (o "Usuarios de base de datos").
Asegúrate de que el usuario que usas en wp-config.php esté listado.
Si no está, añádelo: selecciona el usuario de la lista desplegable y asígnalo a la base de datos.
Marca todos los privilegios (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP) para que WordPress funcione correctamente.

[INFO] Si añadiste un nuevo usuario, recuerda actualizar wp-config.php con sus credenciales.

Paso 4: Revisa el servidor de base de datos (host)

El parámetro DB_HOST suele ser localhost, pero en algunos entornos compartidos puede ser diferente. Por ejemplo, en algunos hostings de Plesk, el servidor de bases de datos puede ser algo como 127.0.0.1 o un socket Unix.

Prueba con diferentes valores

Si localhost no funciona, prueba:

127.0.0.1
El nombre del contenedor o servidor (pregunta a tu hosting)
Si usas Syspanel, suele ser localhost o 127.0.0.1.

Para saber el valor exacto, puedes crear un archivo PHP de prueba:

Crea un archivo llamado testdb.php en la raíz de tu sitio.
Pega este código:

<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');
if (!$link) {
    die('Error: ' . mysqli_connect_error());
}
echo 'Conexión exitosa';
mysqli_close($link);
?>

Sustituye tu_usuario, tu_contraseña y tu_base_datos por los datos reales.
Accede a tudominio.com/testdb.php. Si ves "Conexión exitosa", el problema está en otro lado. Si ves un error, te dirá si es por el host, usuario o contraseña.

[WARNING] Borra este archivo inmediatamente después de la prueba, ya que expone credenciales.

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

En raras ocasiones, la base de datos se corrompe. WordPress tiene una herramienta para repararla.

Activar el modo de reparación

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_ALLOW_REPAIR', true);

Guarda el archivo.
Accede a tudominio.com/wp-admin/maint/repair.php.
Verás dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Elige la segunda para mayor seguridad.
Espera a que termine. Si todo va bien, verás mensajes de éxito.
IMPORTANTE: Vuelve a editar wp-config.php y elimina la línea que añadiste. Si no, cualquiera podría reparar tu base de datos.

[TIP] Si el error persiste, contacta con tu hosting. Pueden tener herramientas internas de reparación.

Paso 6: Verifica que la base de datos no haya sido eliminada

A veces, por error, se elimina una base de datos o un usuario. En Plesk:

Ve a Bases de datos dentro de tu dominio.
Si la lista está vacía, significa que no hay base de datos asignada a tu sitio.
Si falta, tendrás que crearla de nuevo e importar una copia de seguridad. Si no tienes copia, contacta con tu hosting (pueden tener una).

[WARNING] Si no tienes backup, perderás todo el contenido. Siempre mantén copias de seguridad periódicas.

Paso 7: Comprueba el límite de conexiones

En servidores compartidos, puede haber un límite de conexiones simultáneas a la base de datos. Si tu sitio recibe mucho tráfico, podrías superarlo.

En Plesk

Ve a Herramientas y ajustes > Configuración de servidor > MySQL (o similar).
Busca el parámetro max_connections. Si es muy bajo (por ejemplo, 30), puedes solicitar un aumento a tu proveedor.

[INFO] Si no puedes cambiarlo, considera optimizar tu sitio (caché, plugins ligeros) para reducir conexiones.

Paso 8: Revisa los logs de errores

Los logs pueden darte pistas precisas.

En Plesk

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Registros (o "Logs").
Busca el archivo error_log (Apache) o nginx_error.log.
También puedes revisar el log de MySQL: en Herramientas y ajustes > Administración de servicios > haz clic en el icono de MySQL y luego en "Ver registro".

Busca líneas con "database connection", "Access denied" o "Can't connect". Te indicarán el problema exacto.

Preguntas frecuentes (FAQ)

¿Puedo solucionar el error sin acceso a Plesk?

Sí, si solo puedes acceder por FTP. Edita wp-config.php con las credenciales correctas. Si no sabes las credenciales, contacta con tu hosting.

¿Qué hago si el error aparece después de migrar mi sitio?

Es muy común. Revisa que el nombre de la base de datos, usuario y contraseña en wp-config.php correspondan a los del nuevo servidor. También verifica que el DB_HOST sea correcto (a veces cambia).

¿El error puede deberse a un plugin?

Sí, aunque es raro. Si el error empezó después de instalar un plugin, desactívalo por FTP renombrando la carpeta del plugin en wp-content/plugins. Si se soluciona, el plugin era el culpable.

¿Cómo evito que esto vuelva a pasar?

Mantén copias de seguridad automáticas (muchos hostings las ofrecen).
No modifiques credenciales sin actualizar wp-config.php.
Usa contraseñas seguras y cámbialas periódicamente.
Monitorea el estado de tu servidor con herramientas como UptimeRobot.

Conclusión

El error conexión base datos en WordPress con Plesk es frustrante, pero siguiendo estos pasos podrás resolverlo en la mayoría de los casos. Empieza por lo más simple (credenciales) y ve subiendo en complejidad. Si después de todo el error persiste, no dudes en contactar con el soporte técnico de tu hosting: ellos tienen acceso directo a los servicios y pueden diagnosticar problemas más profundos.

Recuerda: la paciencia y el método son tus mejores aliados. ¡Tu sitio web estará online de nuevo en poco tiempo!