Entras en tu web y, en lugar de tu contenido, te encuentras con una frase lapidaria: «Error al establecer una conexión con la base de datos» (o su versión en inglés: Error establishing a database connection).
Es el equivalente digital a intentar abrir tu tienda y descubrir que la llave no gira. En este artículo, vamos a diseccionar por qué ocurre esto y cómo puedes solucionarlo paso a paso sin perder la calma.
1. ¿Qué está pasando realmente? (el diagnóstico)
WordPress funciona gracias a dos pilares: tus archivos (PHP) y tu base de datos (MySQL). El error ocurre cuando los archivos no pueden «hablar» con la base de datos. Para realizar un diagnóstico de salud y rendimiento web efectivo, debemos analizar estos 7 sospechosos habituales:
- Credenciales incorrectas: El usuario o la contraseña han cambiado recientemente.
- Base de datos corrupta: Alguna tabla se ha dañado tras un apagado brusco del servidor o un plugin mal gestionado.
- Servidor caído o saturado: Tu hosting no puede procesar más peticiones por falta de recursos.
- Permisos insuficientes: El usuario de la base de datos existe, pero no tiene los privilegios necesarios para leer o escribir en las tablas.
- Cambios en el servidor o migración: Si acabas de mudar tu web, es probable que el nombre del host (DB_HOST) haya cambiado de «localhost» a una IP específica.
- Archivos del núcleo corruptos: Una actualización fallida puede haber dañado archivos críticos como
wp-db.php, impidiendo la conexión. - Problemas de red: En infraestructuras complejas donde la base de datos está en un servidor externo, un fallo en el «túnel» de conexión o el firewall puede bloquear el acceso.
Si buscas profundizar en cómo mantener la estabilidad de tu sitio, te recomiendo revisar nuestras guías avanzadas de salud web.
2. Solución nivel 1: El archivo wp-config.php
El 90% de las veces, el problema está aquí. Es el archivo que guarda las «llaves» de tu web.
Qué revisar:
Accede vía FTP o a través del Administrador de Archivos de tu hosting y busca el archivo wp-config.php. Verifica que estos cuatro campos coincidan exactamente con los de tu panel de control:
DB_NAME: Nombre de la base de datos.DB_USER: Usuario de la base de datos.DB_PASSWORD: Contraseña.DB_HOST: Normalmente eslocalhost, pero tras una migración, esto suele cambiar.
Consejo: Un simple espacio en blanco al final de la contraseña al copiar y pegar puede romper la conexión. Revisa carácter por carácter.
3. Solución nivel 2: Reparar la base de datos
Si tus credenciales están bien, es posible que la base de datos esté corrupta. WordPress tiene una herramienta integrada para esto:
- Añade esta línea a tu archivo
wp-config.php:define('WP_ALLOW_REPAIR', true); - Visita la URL:
tudominio.com/wp-admin/maint/repair.php - Haz clic en «Reparar base de datos».
- ¡Importante! Una vez terminado, borra la línea que añadiste por seguridad.
4. Solución nivel 3: El servidor y la red
Si el error es intermitente, no es configuración, es un problema de rendimiento.
Esto ocurre cuando el servidor MySQL se apaga por falta de RAM o CPU. Un servidor que no responde suele ser síntoma de un hosting que se ha quedado pequeño o de una web que necesita una limpieza profunda de tablas sobrantes para recuperar su agilidad.
5. Prevención: Cómo evitar que vuelva a suceder
En Web Site Story creemos que la mejor reparación es la que no hace falta realizar. Para evitar este error en el futuro:
- Mantenimiento proactivo: Limpia tu base de datos de revisiones de posts y comentarios de spam semanalmente.
- Optimización WPO: Cuanto menos «pese» la consulta a la base de datos, menos sufrirá tu servidor.
- Auditoría de permisos: Asegúrate de que el usuario de la base de datos solo tiene los privilegios necesarios.
¿Sigues viendo el error?
Si has seguido estos pasos y el problema persiste, probablemente el servicio de MySQL de tu servidor esté caído o los archivos del núcleo estén dañados, y solo una intervención técnica manual podrá recuperarlos.
La tecnología debe ser transparente. Si este error te está quitando el sueño y buscas una solución definitiva respaldada por una estrategia de rendimiento real, hablemos. En mi estudio nos encargamos de que tu conexión sea siempre sólida como una roca.
