Entras en tu web y en lugar de tu página de inicio aparece una pantalla en blanco con una frase seca: «Error al establecer una conexión con la base de datos». Sin menú, sin contenido, sin acceso al escritorio. Es uno de los fallos más angustiantes de WordPress, porque parece que la web ha desaparecido de golpe. La buena noticia es que casi nunca significa que hayas perdido tu contenido: en la mayoría de los casos, la información sigue intacta y lo que falla es la comunicación entre dos piezas. Vamos a ver por qué ocurre y cómo se soluciona.
Qué significa realmente este error
Una web de WordPress tiene dos mitades: los archivos (el tema, los plugins, las imágenes) y la base de datos MySQL, donde viven las entradas, las páginas, los usuarios, los pedidos y la configuración. Cada vez que alguien visita tu web, WordPress pide esa información a la base de datos para construir la página al vuelo.
Cuando ves este mensaje, lo que está diciendo WordPress es simple: «he intentado hablar con la base de datos y no me ha contestado». No dice que los datos se hayan borrado, ni que la web esté hackeada. Dice que la conversación se ha cortado. Y esa distinción es importante, porque evita que tomes decisiones precipitadas como reinstalar WordPress o restaurar una copia antigua encima de todo.
Las causas más habituales
En nuestra experiencia dando soporte, prácticamente todos los casos entran en una de estas cinco categorías. Identificar cuál es la tuya ahorra horas de pruebas a ciegas.
1. Credenciales incorrectas en wp-config.php
El archivo wp-config.php guarda el nombre de la base de datos, el usuario, la contraseña y el servidor. Si alguno de esos cuatro datos deja de ser válido, la conexión falla al instante. Suele pasar después de una migración, de un cambio de hosting o de que alguien haya cambiado la contraseña del usuario de base de datos desde el panel del proveedor.
2. El servidor MySQL está caído o saturado
Las credenciales son correctas, pero al otro lado no hay nadie escuchando. Ocurre cuando el servicio de base de datos se ha detenido, cuando el servidor ha agotado la memoria o cuando tu plan de hosting ha llegado al límite de conexiones simultáneas. Es típico en alojamientos compartidos con picos de tráfico o con vecinos ruidosos consumiendo recursos.
3. La base de datos está corrupta
Un corte de luz en el servidor, una actualización interrumpida o un plugin escribiendo mal pueden dejar tablas dañadas. Aquí el síntoma suele ser intermitente: la portada carga y el escritorio no, o al revés. WordPress incluye una herramienta de reparación integrada pensada exactamente para esto.
4. Has superado la cuota de tu alojamiento
Muchos hostings suspenden el acceso a la base de datos cuando superas el espacio contratado o cuando hay una factura impagada. No siempre avisan con un mensaje claro: simplemente cortan. Si el error apareció de un día para otro sin que nadie tocara nada, revisa tu panel y tu correo antes de nada.
5. Un plugin o tema mal programado
Una extensión que lanza consultas pesadas o infinitas puede tumbar la base de datos por agotamiento. La pista es que el error apareció justo después de instalar o actualizar algo. Suele ser el caso más fácil de revertir, pero también el que más se repite si no se corrige la causa.
Cómo diagnosticarlo paso a paso
Antes de tocar ningún archivo, dedica cinco minutos a acotar el problema. Este orden va de lo menos invasivo a lo más técnico:
- Comprueba si el escritorio da otro mensaje. Entra en /wp-admin/. Si ahí aparece un aviso de que la base de datos necesita reparación, ya tienes la respuesta: es corrupción de tablas.
- Mira el estado del hosting. Entra en el panel de tu proveedor y revisa avisos, consumo de espacio y estado del servicio MySQL.
- Revisa si hubo cambios recientes. Actualizaciones, migraciones, cambios de contraseña o instalaciones de plugins en las últimas horas.
- Verifica las credenciales del archivo wp-config.php contra las que aparecen en el panel de tu hosting, campo por campo.
Si tu web forma parte de un sistema de monitorización de disponibilidad, el aviso te habrá llegado en minutos y sabrás la hora exacta de la caída, lo que ayuda muchísimo a correlacionarla con un cambio. Si aún no tienes nada así, te contamos cómo montarlo en nuestra guía sobre cómo monitorizar el uptime de tu WordPress.
Cómo solucionarlo según la causa
Credenciales incorrectas. Edita wp-config.php y corrige los valores de DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los datos reales del panel. Ojo con DB_HOST: no siempre es localhost, algunos proveedores usan un servidor dedicado. Haz siempre una copia del archivo antes de editarlo.
Tablas corruptas. Añade a wp-config.php la línea que activa la reparación, entra en /wp-admin/maint/repair.php, ejecuta el proceso y elimina esa línea inmediatamente después: mientras esté activa, cualquiera puede acceder a esa pantalla sin estar identificado.
Servidor saturado o caído. Aquí no hay nada que puedas arreglar desde WordPress: toca abrir incidencia con tu hosting. Si se repite cada semana, el problema no es puntual, es de plan. Compara opciones en nuestro artículo sobre hosting compartido frente a VPS.
Plugin culpable. Sin acceso al escritorio, renombra por FTP la carpeta del plugin sospechoso dentro de wp-content/plugins. Eso lo desactiva y, si la web vuelve, tienes al responsable identificado.
Si nada de esto funciona, lo siguiente es restaurar una copia de seguridad reciente. Y si resulta que no tienes ninguna, no todo está perdido: hay caminos, aunque sean más lentos, y los explicamos en la guía sobre cómo recuperar tu web sin copia de seguridad. Cuando la urgencia aprieta y no quieres experimentar con tu web en producción, nuestro servicio de reparación urgente de WordPress se encarga del diagnóstico y la recuperación.
Cómo evitar que vuelva a pasar
Este error rara vez es mala suerte pura. Casi siempre hay una condición previa que llevaba tiempo avisando: una base de datos hinchada, un plan de hosting justo o un plugin que nadie revisaba. La prevención se resume en cuatro hábitos:
- Copias de seguridad automáticas y externas, verificadas de vez en cuando restaurándolas de prueba.
- Monitorización activa para enterarte tú antes que tus clientes.
- Actualizaciones controladas, probadas en un entorno de pruebas y no directamente en producción.
- Limpieza periódica de la base de datos, que además mejora los tiempos de carga.
Ninguno de estos cuatro puntos es complicado por separado. El problema es que exigen constancia, y la constancia es justo lo que falta cuando estás sacando adelante un negocio. Por eso existe el mantenimiento profesional: para que esta pantalla no llegue a aparecer nunca.
Preguntas frecuentes
¿He perdido el contenido de mi web?
Casi con total seguridad, no. Este error indica un fallo de conexión entre WordPress y la base de datos, no una pérdida de información. Tus entradas, páginas y pedidos siguen almacenados. Lo que hay que restablecer es el acceso, y en la mayoría de casos se recupera todo íntegro.
¿Puede ser síntoma de un hackeo?
Es posible, aunque no es la causa más frecuente. Un atacante podría haber modificado wp-config.php o saturado el servidor. Si al recuperar el acceso encuentras usuarios administradores que no reconoces o archivos extraños, conviene hacer un análisis de seguridad completo además de arreglar la conexión.
¿Cuánto se tarda en solucionarlo?
Depende de la causa. Un error de credenciales se corrige en pocos minutos. Una reparación de tablas suele llevar menos de media hora. Si el origen está en el servidor del hosting, el tiempo depende de tu proveedor. Lo que más alarga el proceso es no diagnosticar bien y probar soluciones al azar.
