Si te has topado con el mensaje «Error al establecer una conexión con la base de datos» en WordPress, no estás solo. Es uno de los fallos más habituales y, aunque asusta, casi siempre tiene arreglo. La clave está en entender que WordPress no puede comunicarse con MySQL o MariaDB, y eso puede pasar por varias razones: desde una contraseña mal escrita hasta un servidor caído.
Lo primero que debes saber es que este error no siempre significa que tu web esté rota para siempre. Muchas veces es un problema temporal del hosting o un despiste en el archivo wp-config.php. Vamos a desglosar las causas y las soluciones paso a paso, sin rodeos.
¿Por qué WordPress pierde la conexión con la base de datos?
El error de conexión a la base de datos en WordPress aparece cuando el CMS no puede autenticarse con el servidor de bases de datos. Esto ocurre en el archivo wp-config.php, donde se guardan el nombre de la base de datos, el usuario, la contraseña y el host. Si alguno de estos datos falla, WordPress lanza el mensaje y se queda bloqueado.
Las causas más comunes son:
- Credenciales incorrectas en wp-config.php (nombre de BD, usuario o contraseña).
- El servidor de base de datos está caído o sobrecargado.
- El host de la base de datos cambió (por ejemplo, de localhost a una IP).
- Archivo wp-config.php corrupto o con caracteres extraños.
- Límite de conexiones alcanzado en tu plan de hosting.
En mi experiencia, cuando trabajas con hostings baratos, el problema suele ser el límite de conexiones simultáneas. Si tu web tiene mucho tráfico y el plan es básico, MySQL se queda sin recursos y WordPress no puede conectar. Ahí no hay magia: toca ampliar el plan o mover la base de datos a un servidor dedicado.
Cómo verificar si la base de datos está funcionando
Antes de tocar nada, comprueba si el servidor de base de datos responde. Accede a tu panel de control de hosting (cPanel, Plesk, etc.) y busca la sección de bases de datos. Si usas phpMyAdmin, intenta entrar. Si no carga o da error, el problema está en el servidor, no en WordPress.
También puedes contactar con tu proveedor de hosting. Pregúntales directamente si el servicio MySQL está operativo. A veces ellos ya saben que hay una incidencia y te ahorras media hora de pruebas.
Si tienes acceso por SSH, puedes probar un comando simple como mysql -u usuario -p para ver si la autenticación funciona. Si te da error de acceso denegado, las credenciales están mal. Si te da error de conexión rechazada, el servidor está caído.
Revisa el archivo wp-config.php: el 80% de los fallos están aquí
El archivo wp-config.php es el corazón de la conexión. Ábrelo con un editor de texto (mejor usa FTP o el gestor de archivos del hosting) y revisa estas líneas:
- DB_NAME: el nombre exacto de tu base de datos.
- DB_USER: el usuario que creaste en el hosting.
- DB_PASSWORD: la contraseña, sin espacios extra.
- DB_HOST: normalmente localhost, pero algunos hostings usan una IP o un puerto específico.
Un error típico es copiar y pegar la contraseña y que se cuele un espacio al final. También pasa que el hosting cambia el prefijo de la base de datos y tú sigues usando el antiguo. Revisa cada carácter.
Si tienes dudas, borra las comillas simples y vuelve a escribirlas. A veces el editor introduce comillas tipográficas (las curvas) que PHP no reconoce. Usa siempre comillas rectas.
Prueba a conectar manualmente con phpMyAdmin
Si phpMyAdmin te deja entrar con los mismos datos que tienes en wp-config.php, entonces el problema no son las credenciales. Si no te deja, ya sabes dónde está el fallo: o la contraseña es incorrecta o el usuario no tiene permisos sobre esa base de datos.
En cPanel puedes cambiar la contraseña del usuario de la base de datos y actualizarla luego en wp-config.php. Es una forma rápida de descartar. Asegúrate también de que el usuario está asignado a la base de datos con todos los privilegios.
Un detalle que muchos pasan por alto: algunos hostings separan el servidor de bases de datos del de aplicaciones. En esos casos, localhost no funciona y debes usar el hostname que te proporcionen. Si no lo sabes, pregúntalo.
Renombrar wp-config.php: el truco de emergencia
Si nada de lo anterior funciona, prueba a renombrar el archivo wp-config.php a algo como wp-config-old.php. Luego accede a tu sitio. WordPress detectará que no encuentra el archivo de configuración y te pedirá los datos de conexión. Si los introduces correctamente, creará un nuevo wp-config.php.
Ojo: este método solo funciona si el problema está en el archivo, no en el servidor. Si el servidor de base de datos está caído, no servirá de nada. Pero si el archivo estaba corrupto o tenía un error de sintaxis, esta es la solución más limpia.
Antes de hacer esto, haz una copia de seguridad del archivo original. Nunca se sabe si necesitarás volver atrás. Y si tu sitio tiene datos sensibles, mejor haz un backup completo de la base de datos con phpMyAdmin o desde el hosting.
Otras causas menos obvias que debes considerar
A veces el error de conexión a la base de datos en WordPress viene por un plugin o tema corrupto. Si acabas de instalar algo y apareció el fallo, desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins-off. Si el sitio vuelve, ve activando uno a uno para encontrar al culpable.
También puede ser un problema de permisos. El archivo wp-config.php debe tener permisos 644 o 600, y la carpeta contenedora 755. Si están mal, el servidor no puede leerlo. Revisa esto desde tu cliente FTP.
Y no descartes un ataque. Si alguien ha modificado tu wp-config.php para inyectar código malicioso, la conexión puede fallar. Compara el archivo con una copia limpia o revisa las últimas fechas de modificación.
Cuándo es momento de llamar al hosting
Si has probado todo lo anterior y sigues sin poder conectar, es hora de abrir un ticket. Los proveedores de hosting tienen acceso a los logs del servidor y pueden decirte exactamente qué está fallando. A veces el problema es una caída general que ellos ya están resolviendo.
No pierdas horas dando vueltas. Un buen soporte técnico te ahorra tiempo y dolores de cabeza. Eso sí, elige hostings que respondan rápido. Los baratos suelen tardar días, y eso para una web en producción es un desastre.
Recuerda que este error no es el fin del mundo. Con paciencia y los pasos adecuados, tu WordPress volverá a conectar con la base de datos. Y si todo falla, siempre te queda restaurar una copia de seguridad reciente. Tenla siempre a mano.
