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

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los sustos más comunes al gestionar una web: el temido error de conexión a la base de datos en WordPress. No te preocupes, es más fácil de arreglar de lo que parece. Vamos paso a paso, tanto si usas cPanel como Plesk.

Este error suele aparecer con un mensaje como: "Error establishing a database connection" o "Error de conexión a la base de datos". Es frustrante, pero en el 90% de los casos se soluciona revisando cuatro puntos clave. Te explico todo de forma sencilla.

¿Qué significa este error?

WordPress necesita una base de datos para guardar tus artículos, usuarios, comentarios y configuraciones. El error base de datos WordPress aparece cuando tu web no puede comunicarse con esa base de datos. Las causas pueden ser:

Datos incorrectos en el archivo wp-config.php.
La base de datos o el usuario han sido eliminados o modificados.
El servidor de bases de datos (MySQL/MariaDB) está caído o saturado.
La base de datos está corrupta y necesita reparación.
Problemas de permisos o contraseñas.

No entres en pánico. Vamos a solucionarlo.

Primeros pasos: diagnóstico rápido

Antes de modificar nada, haz estas comprobaciones básicas:

1. Verifica que el servidor esté funcionando

Abre otra página web en el mismo hosting. Si todas tus webs fallan, el problema es del servidor. Contacta a tu proveedor de hosting.

2. Revisa si el error es temporal

A veces es un pico de tráfico o un reinicio del servidor. Espera 5 minutos y recarga la página.

3. Comprueba el estado de la base de datos desde el panel

Accede a cPanel o Plesk y busca la sección de bases de datos. Te explico cómo:

En cPanel:

Busca el ícono "Bases de datos MySQL" o "MySQL Databases".
Verás una lista de bases de datos y usuarios. Asegúrate de que tu base de datos sigue existiendo y que el usuario está asignado.

En Plesk:

Ve a "Bases de datos" en el menú de la izquierda.
Localiza tu base de datos WordPress. Debería aparecer con el nombre de tu dominio o un nombre que reconoces.

[INFO] Si no ves la base de datos, es posible que la hayan eliminado accidentalmente. En ese caso, necesitarás restaurar una copia de seguridad.

Solución 1: Corregir el archivo wp-config.php

El archivo wp-config.php contiene las credenciales de conexión. Si están mal, WordPress no puede conectar. Es la causa más frecuente.

¿Dónde está el archivo?

Está en la raíz de tu instalación de WordPress, normalmente en la carpeta public_html (cPanel) o httpdocs (Plesk).

Pasos para editarlo:

Accede al administrador de archivos de tu panel:
- En cPanel: Busca "Administrador de archivos" (File Manager).
- En Plesk: Ve a "Archivos" y luego al directorio de tu dominio.
Localiza el archivo wp-config.php y haz clic derecho > Editar.

Busca estas líneas (deben estar al inicio del archivo):

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

Verifica que los datos sean correctos:
- DB_NAME: El nombre exacto de tu base de datos.
- DB_USER: El usuario asignado a esa base.
- DB_PASSWORD: La contraseña de ese usuario.
- DB_HOST: Casi siempre es localhost, pero a veces tu hosting usa algo como mysql.tudominio.com. Pregunta a tu soporte si no estás seguro.
Si cambiaste la contraseña recientemente en el panel, actualízala aquí.
Guarda los cambios y recarga tu web.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde el panel de bases de datos. En cPanel ve a "MySQL Databases", busca el usuario y haz clic en "Change Password". En Plesk, entra a la base de datos, ve a "Usuarios" y edita la contraseña. Luego actualiza wp-config.php.

Solución 2: Reparar la base de datos desde WordPress

Si los datos son correctos pero el error persiste, la base de datos puede estar corrupta. WordPress tiene una herramienta de reparación integrada.

Activar el modo de reparación

Edita wp-config.php (como en la solución anterior).
Agrega esta línea justo antes del comentario final /* That's all, stop editing! */:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Accede a esta URL en tu navegador (reemplaza tudominio.com por tu dominio real):
```
https://tudominio.com/wp-admin/maint/repair.php
```
Verás una pantalla con dos opciones:
- "Reparar base de datos" (solo repara).
- "Reparar y optimizar base de datos" (recomendado).
Haz clic en la segunda opción. WordPress intentará reparar las tablas dañadas.
Una vez terminado, vuelve a wp-config.php y elimina la línea que agregaste (o cámbiala a false). Si la dejas, cualquiera podría acceder a la reparación.

[WARNING] No olvides quitar la línea después de reparar. Si no, tu web quedará vulnerable.

Solución 3: Reparar desde el panel de hosting (phpMyAdmin)

Si la reparación desde WordPress no funciona, hazlo manualmente con phpMyAdmin.

Acceder a phpMyAdmin

En cPanel:

Busca "phpMyAdmin" en la sección de bases de datos.
Selecciona tu base de datos en la columna izquierda.

En Plesk:

Ve a "Bases de datos", haz clic en el nombre de tu base.
Busca el botón "phpMyAdmin" o "Administrar".

Reparar tablas manualmente

Selecciona todas las tablas de tu base de datos (marca la casilla superior para elegir todas).
En el menú desplegable (junto a "Con seleccionados:"), elige "Reparar tabla".
phpMyAdmin ejecutará comandos de reparación. Verás resultados como ok o error. Si hay errores, anótalos.
Si no funciona, prueba con "Optimizar tabla" (esto libera espacio y corrige pequeños errores).

[INFO] Si ves muchos errores, puede que la base de datos esté muy dañada. En ese caso, restaura una copia de seguridad reciente.

Solución 4: Verificar el usuario y los permisos de la base de datos

A veces el usuario de la base de datos no tiene todos los permisos necesarios.

En cPanel:

Ve a "MySQL Databases".
En "Usuarios en bases de datos", busca tu usuario y base de datos.
Si no aparece, agrégala usando el menú desplegable.
Asegúrate de que tenga "TODOS LOS PRIVILEGIOS" marcados.

En Plesk:

Ve a "Bases de datos" > selecciona tu base.
Haz clic en "Usuarios".
Edita el usuario y marca "Todos los privilegios".

Solución 5: Cambiar el host de la base de datos

A veces localhost no funciona. Prueba con otras opciones:

127.0.0.1
localhost:3306 (con puerto)
La IP del servidor de bases de datos (pregunta a tu hosting).

Edita DB_HOST en wp-config.php y prueba una a una.

[TIP] En algunos hostings como SiteGround o HostGator, el host puede ser algo como mysql.tudominio.com. Revisa el correo de bienvenida de tu hosting.

Solución 6: Restaurar desde una copia de seguridad

Si nada funciona, restaura una copia de seguridad reciente. Esto es más drástico pero seguro.

Opciones:

Desde cPanel: Busca "Backup" o "JetBackup" y restaura la base de datos.
Desde Plesk: Ve a "Herramientas y configuraciones" > "Administrador de copias de seguridad".
Manual: Si tienes un archivo .sql, impórtalo desde phpMyAdmin.

Preguntas frecuentes (FAQ)

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

Porque wp-config.php sigue usando la contraseña antigua. Actualízala en el archivo.

¿Puedo perder datos si reparo la base de datos?

No, la reparación solo corrige estructuras dañadas. No borra contenido. Pero siempre es recomendable tener una copia de seguridad.

¿Qué hago si el error aparece en todo mi sitio web?

Prueba las soluciones 1 a 3. Si fallan, contacta a tu proveedor de hosting, podría ser un problema del servidor.

¿El error puede ser por un plugin o tema?

Sí, aunque es menos común. Si el error aparece después de instalar algo, desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old desde el administrador de archivos. Si se soluciona, reactiva uno por uno.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad semanales.
No modifiques la base de datos directamente sin saber lo que haces.
Mantén WordPress, temas y plugins actualizados.
Usa contraseñas seguras y cámbialas periódicamente.

Conclusión

El error base de datos WordPress es molesto, pero casi siempre se soluciona revisando wp-config.php, reparando la base de datos o verificando permisos. Tanto en cPanel como en Plesk, las herramientas son similares y fáciles de usar.

Recuerda: si usas Syspanel (antes HestiaCP), el acceso es por el puerto 2106 y los pasos son muy parecidos a cPanel. Busca la sección de bases de datos y sigue las mismas indicaciones.

Espero que este artículo te haya ayudado. Si el error persiste, no dudes en contactar al soporte de tu hosting. ¡Ánimo, que tu web volverá a funcionar en minutos!