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

¿Qué significa el error de conexión a base de datos en WordPress?

Si ves un mensaje como "Error al establecer una conexión a la base de datos" en tu sitio WordPress, no te asustes. Es uno de los problemas más comunes y, por suerte, suele tener solución en pocos minutos. Este error indica que WordPress no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones.

En este artículo te guiaré paso a paso para solucionarlo desde Plesk, el panel de control que probablemente usa tu hosting. No necesitas ser un experto técnico, solo seguir las instrucciones con calma.

¿Por qué ocurre este error?

Las causas más frecuentes 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 saturado.
Problemas de permisos del usuario de la base de datos.
Corrupción en la base de datos tras una actualización o migración fallida.

Vamos a revisar cada posible causa en orden, desde lo más simple a lo más complejo.

Paso 1: Verifica el estado del servidor de base de datos

Antes de tocar archivos, asegúrate de que el motor de base de datos (MySQL/MariaDB) esté funcionando en tu servidor. Esto lo puedes hacer desde Plesk.

Cómo comprobarlo en Plesk:

Inicia sesión en Plesk con tus credenciales de administrador o de hosting.
Ve al menú Herramientas y Configuración (en la barra lateral izquierda).
Busca la sección General y haz clic en Servicios de servidor.
Verás una lista de servicios. Localiza MySQL o MariaDB. Su estado debe ser Ejecutándose (con un círculo verde).
Si aparece Detenido, haz clic en el icono de Iniciar (un triángulo verde) o en el nombre del servicio y luego en Iniciar.

[TIP] Si no ves la opción de iniciar el servicio, puede que no tengas permisos de administrador. En ese caso, contacta a tu proveedor de hosting y pídeles que verifiquen que el servicio MySQL esté activo.

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

WordPress guarda los datos de conexión a la base de datos en un archivo llamado wp-config.php. Si estos datos son incorrectos, se produce el error.

Accede al archivo desde Plesk:

En el panel de Plesk, ve a Sitios web y dominios.
Busca el dominio de tu sitio WordPress y haz clic en Administrar archivos (icono de carpeta).
Navega hasta la carpeta httpdocs (o public_html, dependiendo de la configuración).
Busca el archivo wp-config.php. Haz clic derecho sobre él y selecciona Editar (o Editar en el editor de código).

Verifica estas líneas:

Dentro del archivo, busca un bloque similar a este:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos.
DB_USER: Debe ser el usuario que tiene acceso a esa base.
DB_PASSWORD: La contraseña correcta para ese usuario.
DB_HOST: Normalmente es localhost, pero algunos servidores usan una dirección IP o un nombre como mysql.servidor.com.

[WARNING] Ten mucho cuidado al editar este archivo. No borres ni añadas nada que no sea necesario. Si tienes dudas, copia el contenido a un bloc de notas antes de modificarlo.

¿Cómo obtener las credenciales correctas desde Plesk?

En Plesk, ve a Sitios web y dominios > haz clic en Bases de datos (icono de cilindro).
Verás una lista con las bases de datos de tu sitio. Haz clic en el nombre de la base que usa tu WordPress.
En la página de la base de datos, verás el Nombre de la base de datos y el Nombre de usuario. Si no recuerdas la contraseña, puedes crear una nueva:
- Haz clic en Cambiar contraseña.
- Genera una nueva contraseña segura (Plesk puede sugerirte una).
- Importante: Anota la nueva contraseña.
Ahora, vuelve al archivo wp-config.php y actualiza las líneas DB_NAME, DB_USER y DB_PASSWORD con los datos correctos.
Guarda los cambios y recarga tu sitio web.

Paso 3: Verifica que el usuario tenga acceso a la base de datos

A veces, el usuario existe pero no está asignado a la base de datos correcta. Esto es fácil de solucionar.

Desde Plesk:

Ve a Sitios web y dominios > Bases de datos.
Haz clic en el nombre de tu base de datos.
Busca la sección Usuarios de base de datos. Verás una lista de usuarios asociados.
Si el usuario que aparece en tu wp-config.php no está en la lista, debes añadirlo:
- Haz clic en Añadir usuario.
- Selecciona el usuario existente de la lista desplegable (o crea uno nuevo si es necesario).
- Marca los privilegios que necesite (normalmente Todos es suficiente para WordPress).
- Haz clic en Aceptar.

[INFO] Si creaste un nuevo usuario, recuerda actualizar también el archivo wp-config.php con el nuevo nombre de usuario y contraseña.

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

Si las credenciales son correctas pero el error persiste, la base de datos puede estar dañada. WordPress tiene una herramienta integrada para repararla.

Cómo activar la reparación:

Accede de nuevo al archivo wp-config.php (como en el Paso 2).
Busca la línea que dice:
```
define('WP_DEBUG', false);
```
Justo antes de esa línea (o al final del archivo, antes de /* That's all, stop editing! */), añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Abre tu navegador y visita la siguiente URL (reemplaza tudominio.com por tu dominio real):
tudominio.com/wp-admin/maint/repair.php
Verás una página con dos opciones:
- Reparar base de datos (solo repara).
- Reparar y optimizar base de datos (repara y luego optimiza).
- Recomiendo empezar con Reparar base de datos.
El proceso puede tardar unos segundos. Al terminar, verás un mensaje de éxito o una lista de tablas reparadas.
Muy importante: Una vez terminado, vuelve a editar el archivo 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: Comprueba el servidor de base de datos remoto (si aplica)

Algunos sitios WordPress usan un servidor de base de datos externo (no localhost). Si ese es tu caso, el problema puede ser de red o de configuración del firewall.

Verifica que el DB_HOST en wp-config.php sea correcto (te lo debe proporcionar tu hosting).
Asegúrate de que tu servidor web (donde está Plesk) pueda conectarse al servidor de base de datos remoto. Prueba haciendo ping desde la terminal del servidor (si tienes acceso SSH) o contacta a tu proveedor.

Preguntas Frecuentes (FAQ)

¿Qué hago si después de todo esto el error sigue?

Si has seguido todos los pasos y el error persiste, el problema puede ser más complejo:

El servidor MySQL está sobrecargado. Contacta a tu hosting para que lo revisen.
Hay un plugin o tema corrupto. Puedes desactivarlos temporalmente renombrando la carpeta wp-content/plugins a wp-content/plugins_old desde el administrador de archivos de Plesk. Si el sitio funciona, reactiva uno por uno para encontrar el culpable.
El archivo .htaccess está dañado. Renómbralo a .htaccess_old y luego ve a Ajustes > Enlaces permanentes en tu WordPress (si puedes acceder al admin) para generar uno nuevo.

¿Pierdo datos al reparar la base de datos?

No, la herramienta de reparación de WordPress intenta corregir tablas dañadas sin borrar información. Sin embargo, siempre es recomendable tener una copia de seguridad antes de hacer cualquier cambio.

¿Puedo usar phpMyAdmin desde Plesk para solucionarlo?

Sí, en Plesk puedes acceder a phpMyAdmin desde la sección Bases de datos. Allí puedes ejecutar consultas SQL para reparar tablas, pero es más avanzado. La herramienta de reparación de WordPress es más segura para principiantes.

¿Y si mi hosting usa Syspanel (HestiaCP)?

Si tu panel de control es Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106 (ejemplo: https://tudominio.com:2106). El proceso para solucionar el error es similar: busca la sección de bases de datos, verifica credenciales y usa el administrador de archivos para editar wp-config.php. La lógica es la misma.

Resumen final

El error de conexión a base de datos en WordPress desde Plesk suele resolverse con estos pasos:

Verifica que el servicio MySQL esté ejecutándose en Plesk.
Revisa y corrige las credenciales en wp-config.php.
Asegúrate de que el usuario esté asignado a la base de datos.
Activa la reparación de WordPress como último recurso.
Si nada funciona, contacta a tu soporte técnico.

Recuerda siempre mantener una copia de seguridad actualizada de tu sitio. Con paciencia y siguiendo esta guía, tu WordPress volverá a funcionar en poco tiempo.

[TIP] Si no te sientes cómodo editando archivos, muchos proveedores de hosting ofrecen soporte gratuito para estos casos. No dudes en pedir ayuda.