Introducción al Error de Conexión a la Base de Datos en WordPress
Uno de los problemas más aterradores a los que se enfrentan los administradores de sitios web es el mensaje Error al establecer una conexión con la base de datos en WordPress. Este fallo impide por completo el acceso tanto al sitio web público como al panel de administración (wp-admin), lo que suele generar gran preocupación. Afortunadamente, es un problema común y completamente solucionable si se siguen los pasos adecuados.
¿Cuáles son las causas de este error?
El núcleo de WordPress necesita comunicarse constantemente con su base de datos MySQL o MariaDB para mostrar contenido, gestionar usuarios y cargar configuraciones. Las causas más frecuentes de este fallo incluyen:
- Credenciales incorrectas en el archivo de configuración
wp-config.php. - La base de datos se ha corrompido debido a un apagado inesperado o un fallo en el servidor.
- El servidor de la base de datos (MySQL/MariaDB) está caído o no responde.
- Problemas con los permisos de usuario en el servidor de alojamiento web.
Método 1: Verificar y corregir el archivo wp-config.php
La causa número uno de este error es una discrepancia en los datos de acceso a la base de datos. Para solucionarlo, debes revisar el archivo principal de configuración de tu sitio web.
- Accede a tu servidor mediante un cliente FTP (como FileZilla) o utilizando el Administrador de Archivos de tu proveedor de hosting (cPanel o Plesk).
- Busca la carpeta raíz de tu instalación de WordPress y localiza el archivo llamado
wp-config.php. - Descarga una copia de seguridad del archivo y luego ábrelo con un editor de código plano.
- Verifica que los siguientes parámetros coincidan exactamente con los datos de tu base de datos actual:
define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'nombre_de_usuario');
define('DB_PASSWORD', 'contrasena_correcta');
define('DB_HOST', 'localhost');
Si alguno de estos valores ha cambiado (por ejemplo, tras una migración o cambio de contraseña en el panel del hosting), actualízalos, guarda el archivo y súbelo nuevamente al servidor.
Método 2: Comprobar el estado del servidor de la base de datos
Si tus credenciales son correctas, es muy probable que el propio servidor MySQL de tu proveedor de alojamiento esté experimentando problemas técnicos o se haya quedado sin recursos (memoria RAM o espacio en disco).
- Entra al panel de control de tu hosting (cPanel, DirectAdmin, etc.).
- Busca la herramienta phpMyAdmin e intenta iniciar sesión con las credenciales de tu base de datos.
- Si phpMyAdmin muestra un error de conexión (como
#2002 - El servidor no está respondiendo), significa que el servicio de base de datos de tu servidor está caído. - En este escenario, debes ponerte en contacto con el soporte técnico de tu proveedor de hosting para que reinicien el servicio de MySQL de inmediato.
Método 3: Reparar una base de datos corrupta
Si logras entrar a phpMyAdmin pero tu sitio web sigue mostrando el error, es muy probable que las tablas de la base de datos se hayan corrompido. WordPress incluye una función nativa para diagnosticar y reparar esto.
- Abre tu archivo
wp-config.phpmediante FTP o Administrador de Archivos. - Agrega la siguiente línea de código justo antes de la frase ¡Eso es todo, deja de editar! Feliz publicación:
define('WP_ALLOW_REPAIR', true);
- Guarda los cambios y sube el archivo al servidor.
- Abre tu navegador web y visita 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 que el proceso finalice, es fundamental que elimines la línea de código que agregaste en el archivo
wp-config.phppor razones de seguridad.