Introducción
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, tu sitio web completo y el panel de administración (wp-admin) se vuelven inaccesibles para los visitantes. Afortunadamente, este fallo tiene solución y suele estar relacionado con credenciales incorrectas, un servidor de base de datos caído o tablas corruptas.
¿Cuáles son las causas del error de conexión en WordPress?
Para solucionar este problema de raíz, primero debemos entender qué lo provoca. 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 o MariaDB) no responde o está caído.
- Tablas de la base de datos corruptas debido a un apagado imprevisto, plugins defectuosos o intentos de hackeo.
- Problemas de configuración con el host de la base de datos (por ejemplo, cambiar de
localhosta una IP específica).
Método 1: Verificar y corregir las credenciales en el archivo wp-config.php
El primer paso y el más efectivo es comprobar que los datos de acceso a tu base de datos en el archivo de configuración sean correctos.
- 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
wp-config.php. - Haz una copia de seguridad del archivo antes de realizar cualquier cambio.
- Abre el archivo para editarlo 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' );
- Si has cambiado recientemente la contraseña de tu base de datos en el panel de control de tu hosting (cPanel o Plesk), asegúrate de actualizarla aquí exactamente igual. Guarda los cambios y comprueba si tu sitio web vuelve a funcionar.
Método 2: Reparar la base de datos desde WordPress
Si las credenciales son correctas pero el error persiste, es muy probable que algunas tablas de tu base de datos estén corruptas. WordPress incluye una función nativa para reparar bases de datos.
- Abre nuevamente el archivo
wp-config.phpusando FTP o el Administrador de Archivos. - Desplázate hasta el final del archivo y añade la siguiente línea de código justo antes de la frase "¡Eso es todo, deja de editar!":
define( 'WP_ALLOW_REPAIR', true ); - Guarda los cambios en el archivo.
- Abre tu navegador web y accede a la siguiente URL (reemplaza tudominio.com con tu dirección real):
https://tudominio.com/wp-admin/maint/repair.php - Verás una página con dos opciones. Haz clic en el botón "Reparar base de datos" (o "Reparar y optimizar base de datos").
- Una vez que el proceso finalice, muy importante: regresa a tu archivo
wp-config.phpy borra la línea de código que añadiste en el paso 2 por motivos de seguridad.