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 temido mensaje 'Error al establecer una conexión con la base de datos' en WordPress. Cuando este fallo aparece, significa que tu sitio web no puede comunicarse con la base de datos MySQL o MariaDB donde se almacena toda la información, desde tus publicaciones hasta la configuración del sistema.
Este inconveniente deja tu sitio totalmente inaccesible tanto para los visitantes como para ti en el panel de administración. Afortunadamente, con los conocimientos técnicos adecuados y acceso a tu servidor, es un problema que se puede resolver con relativa facilidad.
Causas Principales del Error
Antes de aplicar cualquier solución, 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). - Un servidor de base de datos (MySQL/MariaDB) que se encuentra caído o no responde.
- Tablas de la base de datos corruptas debido a cierres inesperados, plugins defectuosos o ataques de fuerza bruta.
- Problemas con los permisos de usuario en el servidor de alojamiento web.
Método 1: Verificar y Corregir las Credenciales en wp-config.php
La causa número uno de este error son los datos erróneos de acceso a la base de datos. Si recientemente cambiaste la contraseña de tu base de datos o migraste tu sitio, este archivo debe actualizarse.
- Conéctate a tu servidor mediante un cliente FTP (como FileZilla) o utiliza el Administrador de Archivos de tu proveedor de hosting.
- Localiza la carpeta raíz de tu instalación de WordPress (normalmente llamada
public_html). - Busca el archivo
wp-config.php, haz clic derecho sobre él y selecciona la opción de editar. - Revisa detenidamente los siguientes parámetros de configuración para asegurarte de que coinciden exactamente con los de tu base de datos en cPanel o Plesk:
define('DB_NAME', 'nombre_de_tu_bd');define('DB_USER', 'usuario_de_tu_bd');define('DB_PASSWORD', 'contraseña_correcta');define('DB_HOST', 'localhost'); - Guarda los cambios y recarga tu sitio web en el navegador para comprobar si el error ha desaparecido.
Método 2: Reparar Tablas Corruptas en la Base de Datos
Si las credenciales son correctas pero el problema persiste, es muy probable que algunas tablas de tu base de datos se hayan corrompido. WordPress cuenta con una función nativa para solucionar esto.
- Nuevamente, abre tu archivo
wp-config.phpsiguiendo los pasos del método anterior. - 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 y sube el archivo actualizado al servidor.
- Abre tu navegador web y accede a la siguiente URL (reemplaza tudominio.com por el tuyo):
https://tudominio.com/wp-admin/maint/repair.php - Verás una página con opciones de mantenimiento. Haz clic en el botón Reparar base de datos o Reparar y optimizar base de datos.
- Una vez que el proceso finalice, es muy importante que regreses a tu archivo
wp-config.phpy elimines la línea de código que agregaste, por motivos de seguridad.
Método 3: Comprobar el Estado del Servidor MySQL/MariaDB
Si administras tu propio VPS o servidor dedicado, es posible que el servicio de base de datos se haya detenido inesperadamente.
- Accede a tu servidor mediante SSH utilizando tus credenciales de administrador (root).
ssh usuario@tu_servidor_ip - Ejecuta el siguiente comando para verificar si el servicio MySQL o MariaDB está activo:
sudo systemctl status mysql(omariadbsegún corresponda). - Si el servicio aparece detenido, reinícalo con la siguiente instrucción:
sudo systemctl restart mysql - Si utilizas un servicio de hosting compartido, te recomendamos abrir un ticket de soporte técnico con tu proveedor para que verifiquen si el servidor SQL está experimentando fallas en el clúster.