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 mensaje Error estableciendo una conexión con la base de datos en WordPress. Cuando este error aparece, significa que tu sitio web no puede comunicarse con el servidor de la base de datos MySQL o MariaDB, lo que deja tu página inaccesible tanto para los visitantes como para ti en el panel de administración.
Principales Causas del Problema
Antes de aplicar cualquier solución técnica, es importante entender por qué ocurre este fallo. Las causas más comunes incluyen:
- Credenciales incorrectas en el archivo
wp-config.php(nombre de usuario, contraseña o nombre de la base de datos). - El servidor de la base de datos (MySQL/MariaDB) está caído o no responde debido a una sobrecarga en el alojamiento web.
- Archivos de la base de datos corruptos debido a un cierre inesperado o un ataque malicioso.
- Permisos de usuario mal configurados en el panel de control del hosting (cPanel, Plesk, etc.).
Método 1: Verificar y Corregir los Datos en el Archivo wp-config.php
El primer paso y el más efectivo es revisar que las credenciales de acceso a la base de datos sean correctas en la configuración de tu instalación.
- Conéctate a tu servidor mediante un cliente FTP o utilizando el Administrador de Archivos de tu proveedor de hosting.
- Busca el directorio raíz de tu instalación de WordPress y localiza el archivo llamado
wp-config.php. - Haz una copia de seguridad del archivo antes de realizar cualquier cambio.
- Abre el archivo
wp-config.phpen un editor de texto y verifica las siguientes líneas de código:
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' );
- Compara estos datos exactos con la información de tu base de datos en tu panel de control de hosting (en la sección de bases de datos MySQL). Si algún dato no coincide, actualízalo, guarda los cambios y recarga tu sitio web.
Método 2: Comprobar el Estado del Servidor MySQL/MariaDB
Si las credenciales en el archivo de configuración son correctas, es muy probable que el servidor de la base de datos esté experimentando problemas técnicos.
- Accede al panel de control de tu proveedor de alojamiento web (por ejemplo, cPanel).
- Busca la herramienta de administración de bases de datos, normalmente llamada phpMyAdmin.
- Intenta iniciar sesión en phpMyAdmin utilizando las mismas credenciales que encontraste en tu archivo
wp-config.php. - Si puedes entrar a phpMyAdmin pero tu sitio web sigue mostrando el error, significa que el valor de
DB_HOSTen tu archivo de configuración es incorrecto. En algunos hostings,localhostdebe cambiarse por una dirección IP o un nombre de host específico proporcionado por tu servidor. - Si phpMyAdmin te muestra un mensaje de error de conexión (como
#2003 - Can't connect to MySQL server), el problema proviene directamente del servidor de tu hosting y deberás contactar a su soporte técnico para que reinicien el servicio de base de datos.
Método 3: Reparar una Base de Datos Corrupta
Si la base de datos ha sufrido daños internos, WordPress cuenta con una herramienta nativa para intentar repararla de forma automática.
- Abre tu archivo
wp-config.phpmediante FTP o Administrador de Archivos. - Agrega la siguiente línea de código al final del archivo antes de la frase '¡Eso es todo, deja de editar!':
define( 'WP_ALLOW_REPAIR', true );
- Guarda los cambios y sube el archivo de nuevo a tu servidor.
- Abre tu navegador web y visita la siguiente URL (reemplaza tu dominio):
https://tu-sitio-web.com/wp-admin/maint/repair.php - Verás una pantalla con opciones para reparar la base de datos o repararla y optimizarla. Haz clic en el botón Reparar 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 motivos de seguridad, ya que cualquier usuario podría acceder a esa herramienta sin estar autenticado.