Introducción
El temido mensaje Error al establecer una conexión con la base de datos es uno de los problemas más comunes a los que se enfrentan los administradores de WordPress. Cuando este error aparece, tanto el panel de administración como la página web frontal quedan totalmente inaccesibles, mostrando una pantalla en blanco con este único texto. Afortunadamente, este fallo tiene solución si se siguen los pasos adecuados.
¿Cuáles son las causas de este error en WordPress?
Este problema ocurre principalmente porque WordPress no puede comunicarse con el servidor de la base de datos (MySQL o MariaDB). Las causas más frecuentes 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 está caído o no responde debido a un fallo del proveedor de hosting.
- Tablas de la base de datos corruptas o dañadas.
- Límites de recursos superados en el servidor web.
Método 1: Verificar y corregir los datos en el archivo wp-config.php
La causa número uno de este error son los datos erróneos de conexión en el archivo de configuración principal de tu instalación.
- Accede a tu servidor mediante un cliente FTP o el Administrador de Archivos de tu panel de control (cPanel o Plesk).
- Busca la carpeta raíz de tu instalación de WordPress y localiza el archivo
wp-config.php. - Descarga una copia de seguridad del archivo por precaución y ábrelo con un editor de código.
- Revisa las siguientes constantes y asegúrate de que coincidan exactamente con los datos de tu base de datos:
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' );
- Guarda los cambios, súbelo de nuevo al servidor y comprueba si tu sitio web ya vuelve a funcionar con normalidad.
Método 2: Reparar tablas de la base de datos corruptas
Si las credenciales son correctas pero el problema persiste, es muy probable que algunas tablas de tu base de datos se hayan corrompido.
- Abre el archivo
wp-config.phpnuevamente desde tu cliente FTP. - Agrega la siguiente línea de código justo al final del archivo antes de la línea que dice ¡Eso es todo, deja de editar!:
define( 'WP_ALLOW_REPAIR', true );
- Guarda los cambios y abre en tu navegador 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, es fundamental que borres la línea de código que añadiste al archivo
wp-config.phppor motivos de seguridad.