Error de conexión a base de datos en WordPress Plesk: Cómo solucionarlo

¿Tu sitio WordPress en Plesk muestra el temido mensaje "Error al establecer una conexión a la base de datos"? No te preocupes. Es uno de los problemas más comunes y, aunque puede parecer grave, en la mayoría de los casos se soluciona en pocos minutos. En esta guía extensa y práctica, te explicaré paso a paso cómo diagnosticar y solucionar WordPress Plesk cuando falla la base de datos. Incluye desde comprobaciones básicas hasta soluciones avanzadas, todo explicado como si estuvieras hablando con un técnico amigable.

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

Este error significa que WordPress no puede comunicarse con el servidor MySQL o MariaDB donde están almacenados tus artículos, usuarios y configuraciones. Sin esa conexión, tu web no puede cargar nada. Las causas pueden ser:

Datos de acceso incorrectos
Servicio de base de datos detenido
Configuración incorrecta en Plesk
Problemas de permisos o contraseñas
Archivos dañados (como wp-config.php)

Vamos a ver cada una con soluciones concretas.

Paso 1: Verifica el estado del servicio de base de datos en Plesk

Antes de tocar nada, asegúrate de que el motor de base de datos esté funcionando. En Plesk, esto se hace desde el panel de administración.

¿Cómo acceder a la gestión de servicios en Plesk?

Inicia sesión en Plesk (normalmente en https://tudominio.com:8443).
Ve a Herramientas y Configuración.
En la sección General, haz clic en Gestión de Servicios.
Busca MySQL o MariaDB en la lista. Debería aparecer como "en ejecución".

[INFO] Si ves un círculo rojo o el estado "detenido", haz clic en el botón Iniciar o Reiniciar. A veces un simple reinicio resuelve el error base datos WordPress Plesk.

Paso 2: Comprueba las credenciales en `wp-config.php`

El archivo wp-config.php contiene el nombre de la base de datos, el usuario y la contraseña. Si estos datos no coinciden con los que tienes en Plesk, la conexión falla.

¿Cómo encontrar y editar `wp-config.php`?

Accede a tu panel de Plesk.
Ve a Sitios web y dominios y selecciona tu dominio.
Haz clic en Administrador de archivos.
Ubica la carpeta raíz de tu sitio (normalmente httpdocs o public_html).
Busca el archivo wp-config.php. Si no lo ves, activa "Mostrar archivos ocultos".
Haz clic derecho y selecciona Editar.

¿Qué debes revisar exactamente?

Busca estas líneas y compáralas con los datos de tu base de datos en Plesk:

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

[WARNING] El DB_HOST suele ser localhost, pero si tu base de datos está en un servidor remoto, puede ser una IP o un nombre de dominio. Si no estás seguro, usa localhost primero.

¿Cómo obtener los datos correctos desde Plesk?

En Plesk, ve a Sitios web y dominios.
Haz clic en Bases de datos (a veces aparece como "Bases de datos MySQL").
Verás una lista de bases de datos. Haz clic en el nombre de la que usa tu WordPress.
Allí aparecen: Nombre de la base de datos, Usuario y puedes cambiar la contraseña (si no la recuerdas).

Si cambias la contraseña desde Plesk, debes actualizarla también en wp-config.php. Si no, el error persistirá.

Paso 3: Prueba la conexión manualmente con phpMyAdmin

Para confirmar si el problema es de configuración o del servidor, intenta acceder a la base de datos directamente.

En Plesk, ve a Sitios web y dominios > Bases de datos.
Junto a la base de datos de tu WordPress, haz clic en phpMyAdmin.
Si puedes iniciar sesión con las credenciales que tienes en wp-config.php, entonces la base de datos funciona bien. El problema está en otro lado (por ejemplo, en el archivo de configuración).
Si no puedes acceder, entonces las credenciales son incorrectas o la base de datos está corrupta.

[TIP] Si phpMyAdmin te muestra un error de conexión, reinicia el servicio MySQL desde Plesk (como vimos en el paso 1) y vuelve a intentarlo.

Paso 4: Repara la base de datos desde Plesk

A veces la base de datos sufre corrupción menor que impide la conexión. Plesk permite repararla fácilmente.

Ve a Sitios web y dominios > Bases de datos.
Haz clic en el nombre de la base de datos problemática.
Busca el botón Reparar o Comprobar y reparar. En versiones recientes de Plesk, puede estar en el menú de acciones.
Confirma la reparación. El proceso es automático y rápido.

[INFO] Esta operación no borra datos. Solo corrige índices y tablas dañadas.

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

En Plesk, cada base de datos tiene un usuario asociado con permisos específicos. Si los permisos se han cambiado (por ejemplo, después de una migración), WordPress no podrá conectarse.

¿Cómo comprobar y ajustar permisos?

En la página de la base de datos (dentro de Bases de datos en Plesk), busca la sección Usuarios.
Junto al usuario que usa WordPress, haz clic en Editar o Permisos.
Asegúrate de que tenga marcados al menos estos permisos: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP. (Normalmente se asigna "Todos los privilegios").
Guarda los cambios.

[WARNING] Si no ves ningún usuario asignado, puedes crear uno nuevo o asignar el existente. Asegúrate de que el usuario esté vinculado a la base de datos correcta.

Paso 6: Restablece la contraseña de la base de datos desde Plesk

Si has olvidado la contraseña o crees que ha sido cambiada, restablécela directamente desde Plesk.

Ve a Bases de datos y selecciona la base de datos.
En la sección Usuarios, haz clic en el usuario.
Elige Cambiar contraseña.
Introduce una nueva contraseña segura y cópiala.
Ahora edita wp-config.php y reemplaza la línea define('DB_PASSWORD', 'contraseña_anterior'); por la nueva contraseña.

[TIP] Usa contraseñas que incluyan mayúsculas, minúsculas, números y símbolos. Evita caracteres especiales que puedan causar problemas en el archivo de configuración (como comillas o apóstrofes).

Paso 7: Comprueba si hay problemas de espacio en disco o límites de recursos

A veces la base de datos no puede conectarse porque el servidor se ha quedado sin espacio o ha superado el límite de conexiones.

¿Cómo verificarlo en Plesk?

Ve a Herramientas y Configuración > Información del servidor.
Revisa el uso del disco y la memoria.
Si el disco está al 100%, libera espacio (por ejemplo, borrando backups antiguos o archivos temporales).
También puedes ver los logs de MySQL en Herramientas y Configuración > Logs > Log de MySQL. Busca errores como "Table is full" o "Too many connections".

[INFO] Si el problema es recurrente, considera aumentar los límites de recursos en tu plan de hosting o contactar a tu proveedor.

Paso 8: Usa la herramienta de recuperación de WordPress (si el error persiste)

Si todo lo anterior falla, puedes intentar una solución desde el propio WordPress usando un script de emergencia.

Descarga el archivo wp-config.php desde Plesk (por seguridad, haz una copia).
Añade esta línea justo antes del /* That's all, stop editing! */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y súbelo de nuevo (o edítalo directamente en Plesk).
Ahora visita: https://tudominio.com/wp-admin/maint/repair.php
Verás una página con dos opciones: Reparar base de datos y Reparar y optimizar. Elige la segunda.
Una vez terminado, elimina esa línea del wp-config.php (vuelve a editarlo y bórrala). Si no la quitas, cualquiera podría reparar tu base de datos.

[WARNING] Esta herramienta es poderosa pero solo debe usarse en emergencias. No la dejes activa permanentemente.

Paso 9: Revisa los logs de error de WordPress

Plesk guarda los errores de tu sitio en archivos de log. Pueden darte pistas adicionales.

En Plesk, ve a Sitios web y dominios > Logs.
Busca el archivo error_log en la raíz de tu sitio o en la carpeta wp-content.
Ábrelo y busca líneas que contengan "database", "connect", "MySQL" o "PDO". Te indicarán el error exacto.

[TIP] Si no ves el archivo error_log, puedes crearlo manualmente. En wp-config.php, añade antes del comentario final:

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

Luego visita tu web y revisa el archivo wp-content/debug.log. Recuerda desactivar el modo depuración después.

Paso 10: Contacta al soporte técnico (último recurso)

Si después de todos estos pasos el error base datos WordPress Plesk sigue apareciendo, puede ser un problema del servidor que solo el administrador del hosting puede resolver. Por ejemplo:

El servicio MySQL está caído y no responde a reinicios.
Hay un firewall bloqueando el puerto 3306.
El servidor tiene una configuración incorrecta en los archivos de MySQL.

[INFO] Si tu hosting usa Syspanel (el panel basado en HestiaCP), recuerda que el acceso es por el puerto 2106. En ese caso, los pasos son similares pero la interfaz cambia ligeramente. Busca la sección de bases de datos dentro del panel.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error al establecer una conexión a la base de datos" después de una migración?

Es muy común. Al migrar WordPress, las credenciales en wp-config.php suelen quedar desactualizadas. Revisa el paso 2 y actualiza los datos de la base de datos en el archivo.

¿Puedo perder datos si reparo la base de datos?

No. La reparación solo corrige índices y tablas dañadas, no borra contenido. Sin embargo, siempre es recomendable hacer un backup antes.

¿Qué hago si no puedo acceder a Plesk?

Si no tienes acceso al panel, contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servicio MySQL y ayudarte a resetear la contraseña de la base de datos.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos frecuente. Un plugin mal codificado puede saturar la base de datos o cambiar la configuración. Si el error aparece después de instalar algo nuevo, desactiva todos los plugins renombrando la carpeta wp-content/plugins desde el administrador de archivos de Plesk.

¿Cómo evitar este error en el futuro?

Realiza backups periódicos de tu base de datos.
Mantén WordPress, plugins y temas actualizados.
No modifiques wp-config.php a menos que sepas lo que haces.
Monitorea el espacio en disco y los logs de errores.

Conclusión

El error de conexión a la base de datos en WordPress alojado en Plesk es frustrante, pero casi siempre tiene solución. Siguiendo esta guía paso a paso, podrás solucionar WordPress Plesk sin necesidad de ser un experto técnico. Recuerda empezar por lo más simple (verificar el servicio y las credenciales) y luego avanzar a soluciones más profundas como la reparación de tablas o la revisión de logs.

Si después de todo el error persiste, no dudes en contactar a tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden resolver problemas que escapan al control del panel.

Espero que esta guía te haya sido de ayuda. ¡Tu sitio web volverá a funcionar en poco tiempo!