Guía
«Error al establecer una conexión con la base de datos» en WordPress: causas y solución
Este error significa que WordPress no puede hablar con su base de datos. Las causas más comunes (credenciales en wp-config.php, servidor de base de datos caído, tablas dañadas o límites del hosting) y cómo diagnosticarlas paso a paso.
Este error indica que WordPress no logra conectarse a su base de datos. Las causas más frecuentes son credenciales incorrectas en wp-config.php (usuario, contraseña, nombre de la base o servidor), el servidor de base de datos caído o saturado, tablas dañadas o límites del hosting. Revisa primero wp-config.php y el estado del servicio de base de datos en tu panel, y consulta al soporte del hosting.
Qué significa
El mensaje
WordPress guarda sus contenidos en una base de datos. Si no puede conectarse, muestra «Error establishing a database connection» (o su traducción) y el sitio queda inaccesible. Es un problema de conexión, no necesariamente de contenido perdido. La documentación oficial resume los errores comunes de WordPress.
Paso 1
Comprueba si el panel también falla
Intenta entrar a wp-admin: si muestra el mismo error o un mensaje de reparación, el problema es la conexión o las tablas. Si solo falla la parte pública, puede ser una caché o un archivo. Verifica el estado de tu hosting por posibles caídas o mantenimiento.
Paso 2
Revisa wp-config.php
- DB_NAME: el nombre de la base de datos correcto.
- DB_USER y DB_PASSWORD: el usuario y la contraseña vigentes (si cambiaste la contraseña en el hosting, actualízala aquí).
- DB_HOST: el servidor de la base de datos (a veces es «localhost», pero algunos hostings usan otro).
Los parámetros se describen en la documentación de wp-config.php. Haz copia del archivo antes de editarlo.
Paso 3
Verifica el servicio de base de datos
En el panel del hosting comprueba que el usuario de la base tenga permisos sobre ella y que el servidor esté activo. Si el sitio se saturó (muchas visitas, un ataque o un plugin pesado), la base puede dejar de responder: revisa los registros y límites de recursos del plan.
Paso 4
Reparar tablas dañadas
Si el error sugiere tablas dañadas, WordPress ofrece un modo de reparación que se activa añadiendo una línea en wp-config.php y visitando una dirección específica, como describe la documentación. Haz una copia de seguridad, ejecuta la reparación y elimina la línea después. También puedes usar la herramienta de reparación de tu panel.
Si no se resuelve
Siguientes pasos
- Restaura una copia reciente de la base (probar que tus copias funcionan).
- Pide al soporte del hosting que revise el servidor de base de datos y los registros.
- Descarta que un plugin o tema nuevo cause un bloqueo desactivándolos por SFTP.
- Considera que pudo haber un ataque: qué hacer si tu WordPress fue hackeado.
Prevención
Para que no vuelva
Mantén copias automáticas y probadas, monitorea la disponibilidad, limita plugins pesados y revisa los recursos del hosting. Un mantenimiento regular reduce la probabilidad de caídas: qué incluye un mantenimiento mensual. Si el sitio estuvo caído, revisa en Search Console el efecto en el rastreo: errores 404 y soft 404.
Ejemplo
Un ejemplo práctico (ilustrativo)
Un sitio muestra el error tras cambiar la contraseña de la base en el hosting. Se actualiza DB_PASSWORD en wp-config.php y el sitio vuelve a funcionar. Es un escenario hipotético para ilustrar el método, no un caso real ni una promesa de resultados.
Checklist
Diagnóstico
- ¿Falla también wp-admin?
- Credenciales en wp-config.php.
- Servicio de base de datos activo.
- Permisos del usuario.
- Tablas dañadas y reparación.
- Límites del hosting.
- Copia reciente a mano.
Preguntas frecuentes
Lo que suelen preguntar sobre error de conexión con la base de datos
¿Perdí mi contenido?
Normalmente no; el problema es la conexión. Aun así, ten una copia de seguridad.
¿Puede afectar al SEO?
Si dura horas o días, Google puede ver errores del servidor; resuélvelo rápido.
¿Puedo arreglarlo sin saber de código?
Los casos de credenciales y servidor suelen resolverse con el soporte del hosting.
¿Qué pasa si cambié de hosting?
Actualiza los datos de conexión en wp-config.php.