Qué significa el mensaje y por qué aparece
Cuando entras en tu web y en lugar del contenido habitual te aparece una pantalla casi en blanco con el texto «Error al establecer una conexión con la base de datos», WordPress te está contando algo muy concreto: el PHP de tu sitio intentó hablar con el servidor de base de datos y no recibió respuesta válida. La documentación oficial de WordPress sobre errores comunes lo describe como uno de los más frecuentes.
WordPress necesita una base de datos para leer contenidos, ajustes y cuentas. Ese mensaje aparece cuando no puede utilizar la conexión que espera. Puede deberse a los datos de acceso, al servidor o a un límite alcanzado; el texto de la pantalla no permite elegir una causa por sí solo.
El equipo técnico puede obtener más detalle en registros privados del servidor o de WordPress. No hace falta mostrar esos errores a los visitantes ni reinstalar la web para empezar a investigar. Guarda el mensaje exacto y la hora a la que apareció.
Antes de tocar nada: comprueba y preserva
Antes de cambiar contraseñas o archivos, reúne unas pocas pistas y avisa a quien mantiene la web. Hacer varios cambios a la vez dificulta identificar la causa. Puedes empezar por estas comprobaciones:
- Comprueba si el mensaje aparece también en otra ventana o dispositivo. Anota cualquier diferencia: una copia guardada en caché puede hacer que una página se vea bien aunque la conexión siga fallando.
- Prueba a entrar a
/wp-admin/. A veces el panel devuelve un mensaje distinto («Una o más tablas de la base de datos no están disponibles») que te orienta mejor que la portada. - Si gestionas otras webs en el mismo alojamiento, comprueba si también fallan. Que varias tengan problemas es una pista para el soporte, no una prueba de que todas compartan la misma causa.
- Haz captura del mensaje con fecha y hora. Si más tarde necesitas hablar con el hosting o con quien te mantiene la web, esa captura concreta ahorra discusiones.
- Si hace falta editar
wp-config.php, el equipo debe guardar antes una copia protegida fuera del directorio público de la web. Ese archivo contiene credenciales: no lo dejes como.anteso.baken una carpeta descargable ni lo envíes en una captura.
Con el mensaje, la hora y los cambios recientes, el soporte puede orientar la investigación. No compartas contraseñas para pedir ayuda; los accesos que hagan falta se acuerdan por un canal seguro.
Distinguir WordPress que no conecta de base de datos caída
Con la captura hecha y el wp-config.php a salvo, toca separar dos escenarios que se parecen desde fuera pero piden rutas opuestas. Son estos:
- Escenario 1: la base de datos está viva, WordPress no la encuentra. El servidor de MySQL o MariaDB responde con normalidad a otras herramientas, pero tu instalación de WordPress no se autentica. La causa suele estar en el
wp-config.php: credenciales desactualizadas, un host (DB_HOST) distinto del que espera el hosting, o permisos del usuario revocados. - Escenario 2: el servidor de base de datos no atiende. Está apagado, saturado, en ventana de mantenimiento o rechazando conexiones porque ha llegado a su límite. Aquí no hay nada que tocar en WordPress; la salida es del hosting.
El gestor de bases de datos del alojamiento, como phpMyAdmin, puede aportar una pista. Entrar allí no demuestra que WordPress use el mismo usuario, servidor o conexión; que esa herramienta falle tampoco demuestra por sí solo que la base esté caída. Pide al soporte que compruebe la conexión que utiliza esa instalación concreta.
Añade a la foto dos pistas más. Primera, mira el estado del servicio en el panel del hosting (o en su página de estado); muchos incidentes grandes se avisan ahí antes de que la gente escriba al soporte. Segunda, revisa si ha habido una migración reciente: cuando una web cambia de proveedor o de servidor, es habitual que el nombre de la base de datos, el usuario o el host cambien y el wp-config.php se quede apuntando al anterior.
Causas más habituales en una pyme
En webs pyme el repertorio de causas se repite. Conocerlas ayuda a elegir por dónde mirar primero:
- Credenciales desactualizadas en
wp-config.php. Alguien cambió la contraseña del usuario de base de datos desde el panel del hosting y nadie la propagó al archivo. El error aparece el día que el sitio intenta reconectar. DB_HOSTque no coincide. La mayoría de hostings usanlocalhost, pero algunos exigen una IP, un dominio interno o un socket Unix. La referencia oficial para editar wp-config.php explica qué valores admite.- Tablas corruptas tras un corte eléctrico o reinicio brusco. El servidor acepta la conexión, pero al leer una tabla clave (como
wp_options) devuelve error. - Límite de conexiones simultáneas alcanzado. Cuando el tope se llena, los nuevos intentos reciben «Too many connections», documentado en la base de conocimiento de MariaDB. Típico en hosting compartido con picos o con un plugin que abre muchas consultas.
- Pico de tráfico o de bots saturando el servidor. No tiene por qué ser un ataque; a veces basta con un bot rastreando a la vez que sale un boletín.
- Plugin recién activado que lanza consultas pesadas. Si instalaste algo en las últimas 48 horas, apúntalo como sospechoso.
- Actualización fallida de PHP o de MySQL/MariaDB. Cuando el hosting migra a una versión nueva y tu sitio no es compatible, el controlador puede dejar de hablar con la base.
- Cuota de disco llena. El servidor no puede escribir y empieza a devolver errores intermitentes.
No vas a saber la causa real hasta que mires, pero esta lista te orienta las primeras preguntas: ¿se cambió algo? ¿se instaló algo? ¿hay aviso del hosting? ¿hay tráfico raro?
Ruta de revisión en orden razonable
Estas comprobaciones ayudan a concretar el problema sin cambiar varios componentes a la vez:
- Consulta el estado del alojamiento. Guarda los avisos y pregunta si el servicio de base de datos o alguna cuota está afectado.
- Explica qué cambió antes del error. Una migración, cambio de contraseña o actualización ayudan a decidir dónde mirar; no confirman la causa.
- Pide comprobar los datos de conexión. El equipo contrastará
DB_NAME,DB_USER,DB_PASSWORDyDB_HOSTcon la configuración real. No pegues sus valores en un correo o foro. - Solicita el error técnico concreto. Un mensaje de acceso denegado, límite de conexiones o tabla dañada permite dirigir la siguiente comprobación. Si hacen falta registros de depuración, el equipo debe guardarlos de forma privada, sin mostrar errores a visitantes. La documentación de depuración de WordPress explica las opciones.
- Comprueba después de cada corrección. Revisad la web y el acceso al panel, y anotad qué cambió y con qué resultado.
Opciones para restaurar el servicio
Con la causa acotada, la salida depende del tipo de daño. Estas son las tres rutas más comunes y el criterio para elegir una u otra:
| Ruta | Cuándo encaja | Qué comprobar después |
|---|---|---|
Corregir credenciales en wp-config.php | El error es de acceso: usuario o contraseña incorrectos, host mal escrito, o migración reciente. phpMyAdmin responde con normalidad. | La web vuelve; el panel /wp-admin/ entra; los cambios quedan guardados en un gestor seguro para que no se repitan en el futuro. |
Reparar tablas desde phpMyAdmin o con WP_ALLOW_REPAIR | El equipo confirma daños en tablas y dispone de una copia protegida. El método depende del motor de base de datos; la herramienta de reparación de WordPress no es adecuada para cualquier daño y su página puede quedar accesible sin iniciar sesión mientras está activada. | La reparación termina sin errores; revisas los avisos de cada tabla; desactivas la constante después de usarla; el sitio responde con normalidad. |
| Restaurar la base de datos desde copia reciente | El equipo confirma que la restauración es adecuada y dispone de una copia verificada. Antes de aplicarla, debe conservar el estado actual y valorar qué datos recientes no están en esa copia. | La restauración carga sin errores; verificas entradas clave (últimos pedidos, últimos comentarios, últimas entradas) para medir la pérdida; anotas la ventana de datos no recuperados. |
El criterio: no elijas la ruta más agresiva sin entender la causa. Reinstalar WordPress o rehacer la base «para probar» cuando el problema está en el hosting solo añade un segundo incidente al primero. Cuando una ruta no está clara, comprueba que tienes una copia de seguridad reciente y recuperable antes de cualquier cambio irreversible.
Cuándo hablar con el hosting y cuándo con quien mantiene tu web
Una parte importante de resolver este error es saber a quién preguntar. Confundir los dominios de responsabilidad hace que pierdas horas escribiendo al interlocutor equivocado:
- El hosting responde por el servidor de base de datos (si está arriba o abajo), el límite de conexiones, las cuotas de disco, las ventanas de mantenimiento planificadas y la versión instalada de MySQL o MariaDB. Si tu web comparte servidor con otras, también responde por el impacto cruzado.
- Quien mantiene tu web (interno o externo) responde por el
wp-config.php, por los plugins instalados, por el tema activo, por las tareas programadas de WordPress y por las copias de seguridad que gestione directamente.
Si no tienes a alguien que mantenga tu web, empieza por pedir al alojamiento que confirme el estado del servicio y las condiciones de conexión. Algunos proveedores también revisan la configuración de WordPress y otros no: depende del soporte contratado. Si hace falta, quien mantiene tu web y el hosting deberán coordinar sus comprobaciones.
Si el hosting confirma que todo está operativo y el error persiste, ahí es cuando la tarea entra en el terreno de WordPress y de quien lo mantiene. No tiene sentido tocar la base a ciegas mientras la causa está fuera de ella.
Evitar que vuelva a ocurrir
Un incidente resuelto no se debe cerrar en frío. Estas son las medidas que suelen compensar el esfuerzo cuando ya has recuperado el servicio:
- Mantén una copia de seguridad reciente y verificada. No basta con que el hosting diga que hay copias; conviene comprobar que la copia se puede restaurar antes de necesitarla de verdad.
- Ajusta el límite de conexiones solo cuando el patrón del sitio lo justifique. Subirlo sin investigar puede ocultar la causa o aumentar el consumo de recursos. Mira primero qué está consumiendo, cámbialo después.
- Vigila el tamaño de la tabla
wp_options. Las opciones marcadas comoautoloadse cargan en cada petición; una tabla hinchada por plugins antiguos hace al servidor más sensible a los picos. - Revisa los componentes si las mediciones apuntan a ellos. El equipo puede localizar consultas costosas o tareas que coinciden con el fallo. La cantidad de plugins o el tipo de función no bastan para señalar al responsable.
- Documenta las credenciales del
wp-config.phpen un gestor seguro. No en un correo ni en un documento compartido sin control. - Suscríbete al estado del hosting. Enterarte antes de que te escriba un cliente mejora la gestión.
Nada de esto garantiza que no vuelva a ocurrir: una incidencia en el servidor del hosting o una actualización fallida pueden pasar aunque hagas todo bien. Lo que sí cambia es que el próximo error te pille con el mapa en la mano y no con las luces apagadas. Si estás valorando si tu proveedor actual te está dando el servicio que necesitas, decidir si cambiar de hosting es una conversación aparte, pero conectada a este tipo de incidentes.
Si quieres que te acompañemos
Si estás delante del error ahora mismo y no tienes claro el siguiente paso, prefieres no tocar a ciegas o quieres una segunda mirada antes de llamar al hosting, cuéntanos qué estás viendo. No necesitas tener un diagnóstico cerrado; con la captura del mensaje y lo que hayas probado nos basta para orientarte sobre la ruta razonable y decidir contigo si vale la pena que miremos nosotros.
Si el problema se repite, podemos valorar qué análisis de rendimiento necesita tu web. El alcance y los accesos se acuerdan antes de empezar; corregir o mantener la instalación se concreta aparte. Para distinguir este mensaje de otros fallos, consulta también la guía del error 500 y el aviso de error crítico.