Introducción
Uno de los problemas más frustrantes a los que se enfrentan los administradores de sitios web es el temido Error al establecer una conexión con la base de datos en WordPress. Cuando este fallo aparece, impide por completo el acceso tanto al panel de administración como al sitio público, mostrando únicamente un mensaje genérico. Afortunadamente, este inconveniente tiene solución si se identifican las causas correctas y se siguen los pasos adecuados.
Causas Principales del Error de Conexión en WordPress
El núcleo de WordPress necesita comunicarse constantemente con su base de datos MySQL o MariaDB para recuperar entradas, páginas, comentarios y configuraciones. Si esta comunicación falla, la página colapsa. Las causas más comunes incluyen:
- Credenciales incorrectas en el archivo
wp-config.php. - Credenciales de la base de datos modificadas en el servidor de hosting.
- Tablas de la base de datos dañadas o corruptas.
- El servidor de la base de datos (MySQL/MariaDB) se encuentra caído o no responde.
- Problemas de permisos o configuración en el proveedor de alojamiento web.
Método 1: Verificar y Corregir los Datos en el Archivo wp-config.php
La causa más frecuente de este error es una discrepancia entre los datos de acceso configurados en WordPress y los reales en tu servidor. Sigue estos pasos para revisarlos:
- Accede a tu servidor mediante un cliente FTP o utilizando el Administrador de Archivos de tu panel de control (cPanel o Plesk).
- Localiza la carpeta raíz de tu instalación de WordPress y busca el archivo
wp-config.php. - Haz una copia de seguridad del archivo antes de realizar cualquier cambio.
- Abre el archivo
wp-config.phpcon un editor de texto y busca las siguientes líneas de código:
define('DB_NAME', 'nombre_de_tu_base_de_datos');define('DB_USER', 'usuario_de_tu_base_de_datos');define('DB_PASSWORD', 'contraseña_correcta');define('DB_HOST', 'localhost');
5. Verifica con tu proveedor de hosting que estos cuatro valores coincidan exactamente con los creados en tu panel de bases de datos MySQL. Si hay alguna discrepancia, corrígela, guarda el archivo y recarga tu sitio web.
Método 2: Reparar la Base de Datos Dañada
Si las credenciales son correctas, es muy probable que la estructura interna de la base de datos se haya corrompido debido a un cierre inesperado del servidor o un fallo en algún plugin. WordPress incluye una herramienta nativa para solucionar esto:
- Abre tu archivo
wp-config.phpnuevamente mediante 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 en el archivo.
- Abre tu navegador web y escribe la siguiente URL (reemplazando tusion.com por tu dominio real):
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, regresa a tu archivo
wp-config.phpy elimina la línea de código que acabas de agregar por motivos de seguridad.
Método 3: Comprobar el Estado del Servidor MySQL/MariaDB
Si tu sitio web está alojado en un servidor propio o en un VPS y los pasos anteriores no surten efecto, es posible que el servicio de la base de datos esté detenido. Accede a tu terminal mediante SSH con privilegios de administrador y ejecuta los siguientes comandos según corresponda:
sudo systemctl status mysql
Si el servicio aparece detenido, reinícialo ejecutando:
sudo systemctl restart mysql
Si utilizas MariaDB, el comando equivalente es sudo systemctl restart mariadb. Si estás en un hosting compartido, te recomendamos contactar inmediatamente al soporte técnico de tu proveedor para verificar si el servidor SQL se encuentra operativo.