Error al establecer una conexión con la base de datos en WordPress: cómo solucionarlo

Abres tu sitio y, en lugar de tu página, aparece un mensaje frío: «Error al establecer una conexión con la base de datos». Es uno de los fallos más angustiantes de WordPress porque tumba el sitio entero —incluido el panel de administración— y no deja pistas claras. La buena noticia: casi siempre tiene solución, y aquí te explico cómo, paso a paso.

Llevo más de 25 años trabajando con WordPress y este error lo veo cada semana. Suele aparecer de tres formas: tras un pico de tráfico, después de actualizar algo, o sin que hayas tocado nada —normalmente, un problema del hosting—. Vamos a descartarlas una por una.

Qué significa realmente este error

WordPress guarda todo tu contenido —entradas, páginas, usuarios, configuración— en una base de datos MySQL. En cada visita hace una consulta para construir la página. Si esa conexión falla, no hay nada que mostrar y verás el error. Las causas se reducen a cuatro: credenciales incorrectas, base de datos corrupta, servidor MySQL caído o saturado, o un archivo del sitio dañado.

Antes de tocar nada: haz una copia de seguridad

Si tienes acceso a los archivos y a la base de datos, haz una copia antes de cambiar nada. Varios de los pasos siguientes modifican configuración crítica, y una copia te permite volver atrás sin riesgo. Si no sabes cómo, ve directo al final: a veces lo más rápido y seguro es que lo revise alguien con experiencia.

1. Comprueba si es un problema del hosting

Descarta primero lo más común: que el servidor de base de datos esté caído o saturado. Si tienes varios sitios en el mismo hosting y todos fallan a la vez, el problema es del servidor, no de tu WordPress. Entra al panel de tu hosting y revisa si el servicio MySQL está activo; si no puedes, contacta a su soporte y pregunta directamente si el servidor de bases de datos está operativo. Muchos casos se resuelven aquí, sin tocar una sola línea de código.

2. Revisa las credenciales en wp-config.php

El archivo wp-config.php, en la raíz de tu sitio, guarda los datos de acceso a la base de datos. Si cambiaste de hosting, migraste el sitio o tu proveedor actualizó algo, estos datos pueden haber quedado desactualizados. Comprueba que coincidan con los de tu hosting cuatro valores: DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. El más traicionero es DB_HOST: casi siempre es localhost, pero algunos hostings usan una dirección distinta. Un solo carácter mal y la conexión falla.

3. Intenta reparar la base de datos

Si las credenciales son correctas, la base de datos puede estar corrupta —algo habitual tras un apagón del servidor o una actualización interrumpida—. WordPress trae una herramienta de reparación oculta. Añade esta línea a tu wp-config.php, justo antes de la línea que dice «Eso es todo, deja de editar»:

Después visita tudominio.com/wp-admin/maint/repair.php y pulsa «Reparar la base de datos». Cuando termine, borra esa línea del archivo: dejarla activa es un riesgo de seguridad, porque cualquiera podría acceder a esa página.

4. Comprueba que el usuario de la base de datos funciona

A veces las credenciales son correctas pero el usuario perdió permisos o la contraseña caducó. La forma rápida de saberlo es entrar a phpMyAdmin desde tu hosting: si puedes abrir la base de datos ahí con esos mismos datos, el problema está en otro sitio; si no puedes, hay que recrear el usuario o restablecer su contraseña desde el panel del hosting.

5. ¿Apareció justo tras actualizar o instalar algo?

Si el error empezó justo después de actualizar WordPress, un plugin o el tema, es posible que un archivo central se dañara a medias. En ese caso suele ayudar reemplazar los archivos del núcleo de WordPress por una copia limpia —sin tocar wp-content ni wp-config.php—. Es un paso más delicado y conviene hacerlo con copia de seguridad por delante.

Cómo evitar que vuelva a pasar

Este error rara vez es casualidad pura: suele avisar de un hosting justo de recursos, de falta de copias de seguridad o de actualizaciones hechas sin red. Un mantenimiento WordPress serio —copias automáticas, monitorización y actualizaciones controladas— hace que, si algo falla, se detecte y se revierta antes de que tus clientes lo noten.

Cuándo conviene llamar a un profesional

Si has llegado hasta aquí y el sitio sigue caído, o no te sientes cómodo editando wp-config.php o tocando la base de datos, no sigas a ciegas: un paso en falso puede complicar la recuperación. Cada hora que tu web está caída pierdes visitas y ventas. En esos casos reparo el sitio yo mismo, normalmente el mismo día.

Preguntas frecuentes

¿Perderé mi contenido por este error?

Casi nunca. El contenido sigue en la base de datos; lo que falla es la conexión, no los datos. En el peor caso —corrupción real— se recupera desde una copia de seguridad reciente, que es justo por lo que conviene tenerlas.

¿Por qué aparece si no he tocado nada?

Lo más común es un problema del hosting: el servidor MySQL se cayó, se saturó por tráfico o tu plan se quedó sin recursos. También puede ocurrir tras un mantenimiento del proveedor que cambió las credenciales.

¿Cuánto cuesta repararlo?

Depende de la causa: un ajuste de credenciales es rápido; una base de datos corrupta o un sitio dañado lleva más. Tras un diagnóstico te doy un precio claro antes de empezar.