Introducción al Error de Conexión a la Base de Datos en WordPress
Uno de los problemas más frustrantes a los que se enfrentan los administradores de sitios web es el temido mensaje "Error al establecer una conexión con la base de datos" en WordPress. Cuando este error aparece, tanto la página principal como el panel de administración (wp-admin) quedan inaccesibles por completo. Afortunadamente, este fallo suele tener solución si se abordan los puntos críticos del servidor y los archivos de configuración.
¿Cuáles son las causas de este error en WordPress?
Este problema indica que WordPress no puede comunicarse con la base de datos MySQL o MariaDB. Las causas más comunes incluyen:
- Credenciales incorrectas en el archivo
wp-config.php. - La base de datos se ha corrompido debido a un apagado inesperado o fallo del servidor.
- El servidor de la base de datos (MySQL/MariaDB) está caído o inactivo en el hosting.
- Problemas con los permisos de usuario en el servidor de base de datos.
Método 1: Verificar y corregir las credenciales en wp-config.php
El primer paso y el más efectivo es comprobar que los datos de acceso a la base de datos coincidan exactamente con los de tu panel de control (cPanel, Plesk, etc.).
- Conéctate a tu servidor mediante un cliente FTP o el Administrador de Archivos de tu hosting.
- Busca y abre el archivo
wp-config.phpsituado en el directorio raíz de tu instalación de WordPress. - Localiza las siguientes líneas de código y verifica que los datos sean correctos:
define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_correcta');
define('DB_HOST', 'localhost');Si has cambiado recientemente la contraseña de la base de datos en tu panel de alojamiento, debes actualizarla también en este archivo exactamente igual.
Método 2: Reparar la base de datos desde WordPress
Si las credenciales son correctas pero el problema persiste, es muy probable que una de las tablas de tu base de datos esté corrupta. WordPress cuenta con una función nativa para solucionar esto.
- Abre nuevamente el archivo
wp-config.phpmediante FTP o Administrador de Archivos. - Agrega la siguiente línea al final del archivo justo antes de la frase "¡Eso es todo, deja de editar!":
define('WP_ALLOW_REPAIR', true); - Guarda los cambios y sube el archivo al servidor.
- Abre tu navegador web y accede a la siguiente URL (reemplaza tudominio.com por el tuyo):
https://tudominio.com/wp-admin/maint/repair.php - Haz clic en el botón Reparar base de datos o Reparar y optimizar base de datos.
- Una vez finalizado el proceso, elimina la línea de código que agregaste en el archivo
wp-config.phppor motivos de seguridad.
Método 3: Comprobar el estado del servidor MySQL/MariaDB
Si tienes un servidor VPS o dedicado (como DigitalOcean, AWS o un servidor propio), es posible que el servicio de base de datos se haya detenido. Debes reiniciar el servicio a través de SSH.
- Conéctate a tu servidor mediante SSH con privilegios de administrador.
- Ejecuta el siguiente comando si utilizas MySQL en Ubuntu/Debian:
sudo systemctl restart mysql - Si utilizas MariaDB, ejecuta:
sudo systemctl restart mariadb - Verifica el estado del servicio para asegurarte de que está activo:
sudo systemctl status mysql
Si el servicio se inicia correctamente, actualiza tu sitio web en el navegador y comprobarás que el error ha desaparecido por completo.