Solucionar error de conexión a base de datos WordPress en Plesk

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a desbloquear uno de los errores más comunes (y más frustrantes) que puedes encontrar al gestionar un sitio web en WordPress, especialmente si usas Plesk como panel de control de hosting.

Seguro que has visto esta pantalla blanca o un mensaje de error que dice algo como: "Error al establecer una conexión a la base de datos" o "Error de conexión a la base de datos". No te preocupes, es un problema muy habitual y, en la mayoría de los casos, tiene una solución rápida y sencilla. Vamos a ver paso a paso cómo solucionarlo.

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

El error de conexión a la base de datos significa que WordPress (tu gestor de contenidos) no puede comunicarse con la base de datos donde se almacenan tus artículos, usuarios, comentarios y configuraciones. Es como si intentaras abrir una puerta con la llave equivocada.

Las causas más frecuentes en un entorno Plesk son:

Credenciales incorrectas en el archivo wp-config.php.
La base de datos o el usuario han sido eliminados o modificados accidentalmente.
El servidor de base de datos está caído o sobrecargado.
Problemas de permisos del usuario de la base de datos.
Corrupción en la base de datos (menos común, pero posible).
Firewall o reglas de seguridad que bloquean la conexión.

No te asustes, vamos a resolverlo juntos.

Paso 1: Lo primero, verifica el estado del servidor

Antes de tocar nada de tu sitio, asegúrate de que el problema no sea general.

### Comprueba si otros sitios funcionan

Si tienes varios sitios en el mismo hosting Plesk, intenta acceder a otro. Si todos fallan, es probable que el servidor MySQL/MariaDB (el motor de base de datos) esté caído. En ese caso, contacta a tu proveedor de hosting.

[TIP] Si solo un sitio falla, el problema está en la configuración de ese sitio. Sigue leyendo.

Paso 2: Accede a Plesk y revisa la base de datos

Plesk tiene una interfaz muy visual para gestionar bases de datos. Vamos a usarla.

### Localiza tu base de datos

Inicia sesión en tu panel Plesk.
En el menú de la izquierda, busca la sección "Bases de datos" o "Databases".
Busca la base de datos asociada a tu sitio WordPress. Normalmente se llama algo como tudominio_wp o tudominio_db.

### Verifica que el usuario y la base de datos existen

Haz clic en el nombre de la base de datos. Dentro verás una lista de usuarios asociados. Debe haber al menos un usuario (por ejemplo, tudominio_user).

[WARNING] Si no ves ningún usuario, o si la base de datos no aparece, es posible que alguien la haya borrado. En ese caso, necesitarás restaurar una copia de seguridad o crear una nueva base de datos y usuario. Si no tienes copia, contacta con soporte técnico.

### Comprueba los permisos del usuario

Dentro de la misma pantalla, asegúrate de que el usuario tenga marcados todos los permisos (SELECT, INSERT, UPDATE, DELETE, etc.). Lo más seguro es marcar "ALL PRIVILEGES" (todos los privilegios).

Paso 3: El archivo clave: `wp-config.php`

Este es el archivo de configuración de WordPress. Aquí se guardan las credenciales de la base de datos. Es el culpable número uno del error.

### Cómo localizar el archivo

Puedes hacerlo de dos formas:

A través del Administrador de archivos de Plesk: En el menú de la izquierda, ve a "Archivos" o "File Manager". Navega hasta la carpeta httpdocs (o public_html). Allí verás el archivo wp-config.php.
A través de FTP/SFTP: Conéctate con un cliente como FileZilla y busca en la raíz de tu sitio.

### ¿Qué información debe contener?

Abre el archivo con un editor de texto (Bloc de notas, Sublime Text, o el editor integrado de Plesk). Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'nombre_de_tu_usuario');
define('DB_PASSWORD', 'contraseña_del_usuario');
define('DB_HOST', 'localhost');

### Compara con los datos de Plesk

Vuelve a la pantalla de "Bases de datos" en Plesk. Allí verás los datos exactos:

Nombre de la base de datos → Debe coincidir con DB_NAME.
Nombre de usuario → Debe coincidir con DB_USER.
Contraseña → Si no la recuerdas, Plesk te permite cambiarla desde el mismo panel. Haz clic en el usuario y selecciona "Cambiar contraseña". Luego actualiza ese valor en wp-config.php.

[INFO] El valor DB_HOST casi siempre es localhost. Si tu hosting usa un servidor separado, te lo habrán indicado. Si no estás seguro, déjalo como localhost.

### Guarda y prueba

Una vez corregidos los datos, guarda el archivo. Vuelve a cargar tu sitio web. Si el error persiste, continúa con el siguiente paso.

Paso 4: Reparar la base de datos

A veces la base de datos se corrompe ligeramente. WordPress tiene una herramienta de reparación oculta.

### Activar el modo de reparación

Abre de nuevo el archivo wp-config.php.
Busca la línea que dice define('WP_DEBUG', false); (o similar).
Justo antes de esa línea, añade esta nueva línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, escribe esta URL (reemplaza tudominio.com por tu dominio real):

tudominio.com/wp-admin/maint/repair.php

Verás una página con dos botones: "Repair Database" y "Repair and Optimize Database". Haz clic en el primero.
Espera a que termine el proceso. Te mostrará un mensaje de éxito o errores específicos.
IMPORTANTE: Una vez terminado, vuelve a wp-config.php y elimina la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Dejarla activa es un riesgo de seguridad.

Paso 5: Reiniciar servicios desde Plesk (si tienes acceso)

Si los pasos anteriores no funcionan, el problema puede ser que el servicio de base de datos esté bloqueado.

### Cómo reiniciar MySQL/MariaDB en Plesk

En el panel de Plesk, ve a "Herramientas y ajustes" (o "Tools & Settings").
Busca la sección "Servicios" y haz clic en "Administración de servicios" (o "Services Management").
Busca el servicio llamado "MySQL" o "MariaDB".
Haz clic en el icono de reinicio (normalmente un círculo con una flecha).
Espera unos segundos y vuelve a cargar tu sitio.

[WARNING] Reiniciar el servicio puede causar una breve interrupción en todos los sitios de tu servidor. Hazlo solo si estás seguro o fuera de horas punta.

Paso 6: Soluciones avanzadas (si nada funciona)

Si has llegado hasta aquí y el error continúa, puede ser un problema más técnico.

### Verificar el archivo de hosts o DNS

En raras ocasiones, el nombre del servidor de base de datos (DB_HOST) no es localhost sino una IP o un nombre de servidor específico. Consulta con tu proveedor de hosting.

### Comprobar el firewall

Algunos firewalls bloquean conexiones a puertos de base de datos (por defecto, el puerto 3306). Si tu hosting tiene un firewall, asegúrate de que permite conexiones desde tu IP (o desde el servidor web).

### Restaurar una copia de seguridad

Si todo falla, la solución más drástica (pero efectiva) es restaurar una copia de seguridad de tu sitio anterior al error. Plesk suele tener copias automáticas. Ve a "Copias de seguridad" (o "Backup") y restaura la base de datos y los archivos.

Preguntas Frecuentes (FAQ)

¿Por qué aparece este error después de cambiar la contraseña de la base de datos?

Es muy común. Al cambiar la contraseña desde Plesk, el archivo wp-config.php no se actualiza automáticamente. Debes editar el archivo y poner la nueva contraseña manualmente (Paso 3).

¿Puedo evitar este error en el futuro?

Sí, con estos consejos:

Guarda siempre las contraseñas en un gestor de contraseñas.
Haz copias de seguridad periódicas (Plesk puede automatizarlas).
No modifiques manualmente las bases de datos a menos que sepas lo que haces.
Mantén WordPress y los plugins actualizados.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Un plugin mal codificado puede intentar conectarse a una base de datos con credenciales incorrectas o saturar el servidor. Si el error apareció justo después de instalar un plugin, desactívalo renombrando su carpeta desde el Administrador de archivos (por ejemplo, cambia wp-content/plugins/nombre-del-plugin a wp-content/plugins/nombre-del-plugin-desactivado).

¿Qué hago si no tengo acceso a Plesk?

Contacta a tu proveedor de hosting. Diles que tienes un "Error de conexión a la base de datos en WordPress" y que necesitas que verifiquen las credenciales o el estado del servidor MySQL.

¿El puerto de acceso a la base de datos es siempre el mismo?

Normalmente es el puerto 3306 para MySQL/MariaDB. Si tu hosting usa un puerto diferente, te lo habrán indicado en la bienvenida. En el archivo wp-config.php, puedes especificarlo así: define('DB_HOST', 'localhost:3307'); (cambiando el número).

Resumen final

El error de conexión a la base de datos es como un cortocircuito en tu web. Siguiendo estos pasos, podrás diagnosticarlo y solucionarlo en pocos minutos:

Revisa el estado del servidor (¿otros sitios funcionan?).
Verifica la base de datos en Plesk (¿existe? ¿tiene usuario?).
Corrige el archivo wp-config.php (credenciales correctas).
Repara la base de datos (modo reparación).
Reinicia el servicio MySQL desde Plesk.
Restaura una copia de seguridad si es necesario.

[TIP] Si en algún momento te sientes perdido, no dudes en pedir ayuda a tu proveedor de hosting. Para eso están.

Espero que este artículo te haya sido de gran ayuda. ¡Tu sitio web volverá a funcionar en un abrir y cerrar de ojos! Si tienes más dudas, recuerda que siempre puedes consultar la documentación de Plesk o buscar en foros especializados. ¡Mucha suerte!