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

¿Te has encontrado con el temido mensaje de "Error al establecer una conexión a la base de datos" en tu WordPress alojado en Plesk? No entres en pánico. Este es uno de los errores más comunes y, por suerte, casi siempre tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto en servidores.

En este artículo, vamos a desglosar paso a paso cómo solucionar error WordPress Plesk cuando la base de datos se niega a cooperar. Desde lo más básico (verificar credenciales) hasta soluciones un poco más técnicas (reparar tablas desde Plesk o phpMyAdmin). Al final, también responderemos a las preguntas más frecuentes para que puedas prevenir este problema en el futuro.

Prepárate para convertirte en el héroe de tu propio sitio web. Vamos allá.

¿Qué significa exactamente "error de conexión a la base de datos"?

Cuando tu sitio WordPress muestra este error, significa que el archivo de configuración principal de WordPress (el famoso wp-config.php) no puede comunicarse con el servidor de bases de datos (normalmente MySQL o MariaDB). Sin esa comunicación, WordPress no puede recuperar tus artículos, páginas, usuarios o configuraciones. Es como si tu coche tuviera el motor pero no la llave de contacto.

Las causas más frecuentes de este error base de datos WordPress Plesk son:

Credenciales incorrectas (nombre de usuario, contraseña, nombre de la base de datos o servidor).
La base de datos está corrupta o tiene tablas dañadas.
El servidor de bases de datos está caído o sobrecargado.
El usuario de la base de datos no tiene permisos suficientes.
Problemas con el archivo wp-config.php (errores de sintaxis, caracteres extraños, etc.).

No te preocupes, vamos a revisar cada una de estas posibilidades en orden, de la más simple a la más compleja.

Paso 1: Verifica las credenciales en el archivo wp-config.php

Este es el primer lugar donde debes mirar. El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress (normalmente en la carpeta httpdocs o public_html). Dentro de este archivo, hay un bloque de código que define los parámetros de conexión a la base de datos.

¿Cómo acceder al archivo?

Accede a tu panel de control Plesk.
Ve a Archivos (o File Manager) dentro del dominio de tu sitio web.
Busca el archivo wp-config.php en la raíz. Si no lo ves, asegúrate de que estás viendo archivos ocultos (en Plesk suele haber un botón para mostrar archivos ocultos).
Haz clic derecho sobre el archivo y selecciona Editar (o Edit in Text Editor).

¿Qué debes buscar exactamente?

Dentro del archivo, busca las siguientes líneas (deberían estar cerca del principio):

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');

Ahora, compara estos valores con los datos reales de tu base de datos. La forma más segura de obtenerlos es desde el propio Plesk:

Ve a Bases de datos en el panel de Plesk.
Busca la base de datos asociada a tu WordPress. Verás el nombre, el usuario y un enlace para Mostrar contraseña.
Copia esos datos exactamente como aparecen.

[TIP] El valor de DB_HOST casi siempre es localhost, pero en algunos servidores gestionados puede ser algo como 127.0.0.1 o incluso un nombre de host específico. Si no estás seguro, consulta con tu proveedor de hosting.

Si los datos no coinciden, corrígelos en el archivo wp-config.php y guarda los cambios. Luego, recarga tu sitio web. Si el error persiste, pasa al siguiente paso.

Paso 2: Repara la base de datos desde Plesk (o phpMyAdmin)

A veces, las tablas de la base de datos se corrompen ligeramente, especialmente si ha habido un corte de energía o un error durante una actualización de WordPress o un plugin. Afortunadamente, repararlas es muy sencillo.

Opción A: Reparar desde Plesk

En el panel de Plesk, ve a Bases de datos.
Haz clic en el nombre de la base de datos de tu WordPress.
Busca un botón que diga Reparar base de datos o Check/Repair. En algunas versiones de Plesk, esta opción está dentro de la sección de phpMyAdmin (ver opción B).
Si ves la opción, simplemente haz clic y espera a que termine el proceso. Plesk ejecutará automáticamente el comando REPAIR TABLE en todas las tablas.

Opción B: Reparar desde phpMyAdmin (más detallada)

phpMyAdmin es una herramienta web para gestionar bases de datos. Plesk la incluye por defecto.

Ve a Bases de datos en Plesk.
Haz clic en el nombre de la base de datos. Verás un enlace o un icono que dice phpMyAdmin. Haz clic.
Se abrirá phpMyAdmin en una nueva pestaña. Verás una lista de todas las tablas de tu WordPress (wp_posts, wp_options, etc.).
Selecciona todas las tablas haciendo clic en la casilla de verificación de la parte superior de la lista.
En el menú desplegable que dice Con seleccionados:, elige Reparar tabla.
phpMyAdmin ejecutará el proceso y te mostrará un mensaje de éxito o de error. Si todo sale bien, vuelve a tu sitio web y recarga.

[WARNING] Reparar tablas es un proceso seguro, pero siempre es buena práctica tener una copia de seguridad reciente de tu base de datos antes de hacer cualquier modificación.

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

Aunque las credenciales sean correctas, el usuario de la base de datos podría no tener todos los permisos necesarios para que WordPress funcione. Esto puede ocurrir si alguien modificó los permisos manualmente o si la base de datos se creó con una configuración incorrecta.

¿Cómo comprobar y otorgar permisos en Plesk?

Ve a Bases de datos en Plesk.
Haz clic en el nombre de la base de datos.
Busca la sección de Usuarios o Usuarios de base de datos. Verás una lista de los usuarios asociados.
Haz clic en el nombre del usuario (o en el icono de editar).
Asegúrate de que tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, etc.). La opción más segura es marcar ALL PRIVILEGES (Todos los privilegios).
Guarda los cambios.

[INFO] Si no ves la opción de editar permisos directamente, puedes hacerlo desde phpMyAdmin: selecciona tu base de datos, ve a la pestaña Privilegios, busca el usuario y haz clic en Editar privilegios. Marca todas las casillas y guarda.

Paso 4: Comprueba si el servidor de bases de datos está funcionando

A veces el problema no está en tu WordPress ni en tu base de datos, sino en el propio servidor de bases de datos. Esto es menos común, pero puede ocurrir.

¿Cómo saberlo?

Desde Plesk: Ve a Herramientas y configuraciones > Servicios. Busca el servicio MySQL o MariaDB. Debería aparecer como Ejecutándose (Running). Si está detenido, puedes intentar iniciarlo desde ahí (aunque normalmente necesitarás permisos de administrador del servidor).
Desde otro sitio web: Si tienes otro sitio web en el mismo servidor que también use base de datos, comprueba si funciona. Si todos fallan, el problema es del servidor. Contacta a tu proveedor de hosting.
Usando un script simple: Crea un archivo test.php en la raíz de tu web con el siguiente contenido (cambiando los valores por los tuyos):

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

Accede a tudominio.com/test.php. Si ves "Conexión exitosa", el servidor funciona y el problema está en otra parte (probablemente en el wp-config.php). Si ves un error, el servidor de bases de datos tiene un problema.

Paso 5: Revisa el archivo wp-config.php en busca de errores ocultos

Además de las credenciales, el archivo wp-config.php puede tener otros problemas. Por ejemplo, un espacio en blanco extra al principio o al final del archivo, o un carácter invisible (como un BOM - Byte Order Mark) que rompe la conexión.

¿Qué hacer?

Abre el wp-config.php con un editor de texto plano (como el Bloc de notas de Windows, TextEdit en Mac, o el editor de Plesk). Nunca uses Word o procesadores de texto porque añaden formato oculto.
Verifica que no haya espacios o líneas en blanco antes de la línea <?php (la apertura de PHP). Lo ideal es que <?php sea la primera línea del archivo.
Verifica que no haya espacios o líneas en blanco después de la última línea (normalmente require_once(ABSPATH . 'wp-settings.php');). El archivo debe terminar justo ahí, sin líneas extra.
Si encuentras algún espacio extra, elimínalo y guarda el archivo.

[WARNING] Si añades o quitas algo mal en este archivo, tu sitio web podría dejar de funcionar por completo. Siempre haz una copia de seguridad del archivo original antes de editarlo.

Soluciones adicionales para casos más complejos

Si después de todos estos pasos el error persiste, es posible que el problema sea más profundo. Aquí tienes algunas opciones avanzadas:

Restaurar desde una copia de seguridad

Si tienes una copia de seguridad de tu base de datos y archivos de WordPress de antes de que apareciera el error, restaurarla es la solución más rápida y segura. Plesk suele tener herramientas de backup integradas (ve a Herramientas y configuraciones > Backup Manager).

Aumentar los límites de memoria de PHP

A veces, un plugin o tema consume demasiada memoria y provoca errores de conexión. Puedes añadir esta línea a tu wp-config.php, justo antes de la línea /* That's all, stop editing! Happy publishing. */:

define('WP_MEMORY_LIMIT', '256M');

Desactivar plugins o temas (si puedes acceder al panel de administración)

Si el error aparece solo en algunas páginas o después de instalar algo, intenta desactivar todos los plugins. Puedes hacerlo renombrando la carpeta wp-content/plugins a wp-content/plugins_old a través del Administrador de archivos de Plesk. Si el sitio se recupera, el problema está en uno de los plugins. Luego, reactívalos uno por uno para identificar al culpable.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error de base de datos después de mover mi web a otro servidor?

Es muy común. Al cambiar de servidor, las credenciales de la base de datos (nombre, usuario, contraseña y especialmente el DB_HOST) cambian. Debes actualizar el wp-config.php con los nuevos datos que te proporcione tu nuevo hosting.

¿Puedo solucionar el error desde el panel de control si no es Plesk?

Sí, los pasos son similares en otros paneles como cPanel, DirectAdmin o Syspanel (anteriormente HestiaCP). En Syspanel, accedes por el puerto 2106 y las opciones de bases de datos están en la sección de "Bases de datos". El concepto es el mismo: verificar credenciales, reparar tablas y comprobar permisos.

¿Qué hago si no puedo acceder a Plesk?

Si no tienes acceso a Plesk, contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servidor de bases de datos, reparar tablas desde su lado, o incluso restablecer la contraseña de la base de datos. También puedes pedirles que te proporcionen los datos de acceso a phpMyAdmin para que puedas reparar las tablas tú mismo.

¿El error puede deberse a un ataque o malware?

Es poco frecuente, pero posible. Algunos malwares modifican el wp-config.php para redirigir el tráfico o robar información. Si sospechas de un ataque, además de solucionar el error de conexión, deberías escanear tu sitio en busca de malware y cambiar todas tus contraseñas (de WordPress, FTP, base de datos, etc.).

Resumen y recomendaciones finales

El error de conexión a la base de datos en WordPress con Plesk puede ser frustrante, pero como has visto, en la mayoría de los casos se soluciona con unos pocos pasos sencillos. Recuerda este orden de actuación:

Verifica las credenciales en wp-config.php.
Repara las tablas desde Plesk o phpMyAdmin.
Comprueba los permisos del usuario de la base de datos.
Asegúrate de que el servidor de bases de datos esté funcionando.
Revisa el wp-config.php en busca de errores ocultos.

Para prevenir futuros problemas, te recomiendo:

Mantén copias de seguridad periódicas de tu base de datos y archivos. Plesk te permite automatizarlas.
Actualiza WordPress, plugins y temas regularmente. Las versiones antiguas son más propensas a errores y vulnerabilidades.
No modifiques el wp-config.php a menos que sepas exactamente lo que estás haciendo, y siempre guarda una copia de seguridad antes.
Contacta a tu proveedor de hosting si el error persiste después de intentar todo lo anterior. Ellos tienen acceso a herramientas y logs que tú no ves.

Espero que esta guía te haya sido de gran ayuda. ¡Ya puedes volver a disfrutar de tu sitio WordPress sin el temido error de base de datos!