Error establishing a database connection: guía de solución paso a paso

📅 Publicado el 4 de noviembre, 2026 · Por Equipo RedServicio

Error establishing a database connection. Si trabajas con WordPress, probablemente ya te ha dado un susto alguna vez: es el mensaje que aparece cuando el CMS no logra hablar con la base de datos MySQL donde vive todo el contenido de tu sitio. El resultado es una página en blanco, o un aviso de error que bloquea el acceso a visitantes y buscadores por igual. La buena noticia: casi siempre se arregla en pocos minutos. Aquí te explico qué significa exactamente el error, por qué suele aparecer y cómo corregirlo paso a paso, con ejemplos concretos.

¿Qué significa el error establishing a database connection y por qué aparece?

WordPress se apoya en dos pilares. Por un lado, los archivos PHP que forman el CMS. Por otro, una base de datos (normalmente MySQL o MariaDB) donde se guardan entradas, páginas, comentarios, usuarios y configuraciones. Cada vez que alguien abre tu web, WordPress lanza una consulta contra esa base para recuperar la información y mostrarla en pantalla.

El mensaje «error establishing a database connection» significa que esa conexión fracasó: WordPress intentó comunicarse con el servidor de bases de datos y no obtuvo respuesta, o las credenciales fueron rechazadas. Y aquí viene lo importante: el problema puede estar en tres niveles distintos.

• En el archivo de configuración: los datos de conexión en wp-config.php son incorrectos o están desactualizados.
• En el servidor de base de datos: el servicio MySQL está caído, sobrecargado o directamente no responde.
• En la propia base de datos: hay tablas corruptas, o la base ha sido eliminada.

Saber en cuál de esos tres niveles está el fallo es justamente lo que aprenderás en esta guía. Un hosting de calidad con soporte 24/7, como el que ofrecemos en RedServicio, reduce mucho la probabilidad de que el origen esté en el servidor. Pero conviene saber diagnosticarlo por ti mismo. Nunca se sabe cuándo lo vas a necesitar.

Causas más comunes de este error en WordPress

Antes de tocar código, echemos un vistazo a los desencadenantes habituales. Los que verás con más frecuencia son estos:

Credenciales incorrectas en wp-config.php

La causa número uno, sin discusión. Suele aparecer tras una migración de hosting, un cambio de contraseña de la base o una restauración de backups a medias. Si el usuario, la contraseña o el host no coinciden con los reales, la conexión no se produce. Así de simple.

Servidor MySQL caído o saturado

Un pico de tráfico (piensa en una mención viral en redes) puede dejar a MySQL sin memoria o hacer que supere su límite de conexiones simultáneas. Y en hostings compartidos hay un detalle que casi nadie tiene en cuenta: un vecino de servidor que consuma demasiados recursos también puede afectarte a ti.

Base de datos o tablas corruptas

Un corte eléctrico en el servidor, una actualización interrumpida a mitad de camino o un plugin defectuoso pueden corromper tablas. WordPress entonces mostrará errores como «La tabla wp_options no existe» junto al mensaje de conexión.

Archivos del núcleo dañados

¿Una actualización de WordPress que se quedó a medias? Puede dejar archivos críticos, incluido el propio wp-config.php, en un estado inconsistente.

Actualizaciones de plugins o temas problemáticas

Algunos plugins optimizan o modifican la base de datos mientras se actualizan. Si ese proceso se corta, las tablas pueden quedar dañadas.

Con este mapa de sospechosos en mente, pasemos a la primera acción correctiva.

Paso a paso: verifica y corrige tus credenciales en wp-config.php

Empieza siempre por aquí. Es la causa más probable y también la más fácil de descartar.

1. Accede a tu servidor por FTP o al gestor de archivos del panel de control de tu hosting y busca el archivo wp-config.php en la raíz de tu instalación de WordPress.
2. Abre el archivo y localiza estas líneas, que suelen estar al principio:

3. Comprueba estos datos contra los reales de tu panel de hosting. Entra en la sección «Bases de datos MySQL» (o similar) de tu cPanel y verifica que el nombre de la base, el usuario y la contraseña coinciden exactamente. Ojo con un detalle: en muchos hostings el usuario y la base llevan un prefijo, algo como cpaneluser_wp001.
4. Verifica DB_HOST: en la mayoría de hostings el valor correcto es localhost, pero algunos proveedores externos de bases de datos usan una URL o una IP concreta.
5. Guarda los cambios y recarga la web. Si el error desapareció, eran las credenciales. Fin de la historia.

¿No recuerdas la contraseña de la base de datos? No pierdas tiempo intentando adivinarla. Créala de nuevo desde el panel de hosting y actualiza el valor en wp-config.php. Y si con las credenciales verificadas el error persiste, toca comprobar el estado del servidor MySQL y reparar posibles tablas corruptas, tal y como veremos en la siguiente parte de esta guía.

Cómo reparar la base de datos de WordPress desde el panel

A veces el error establishing a database connection no viene de credenciales mal escritas, sino de una tabla corrupta. Suele pasar en wp_options o wp_posts: son las tablas que más escrituras soportan y, con los años, acaban resintiéndose. Para estos casos WordPress trae un mecanismo de reparación propio. Solo hay que activarlo. Abre el archivo wp-config.php y añade esta línea justo antes del comentario /* That’s all, stop editing! */:

define(‘WP_ALLOW_REPAIR’, true);

Guarda, y visita https://tudominio.com/wp-admin/maint/repair.php. Allí verás dos opciones: Reparar la base de datos y Reparar y optimizar la base de datos. ¿Cuál elegir? La segunda tarda más, pero si tu web lleva tiempo sin mantenimiento, merece la pena. Un detalle importante (y que mucha gente olvida): cuando termine el proceso, borra la línea de wp-config.php. Esa página es accesible sin ningún tipo de autenticación, y no conviene dejarla expuesta.

También puedes hacerlo a mano con phpMyAdmin, si tu panel lo incluye. Selecciona la base de datos, marca las tablas afectadas y en el menú desplegable «Con la selección» elige Reparar la tabla. Antes, eso sí, exporta una copia completa desde la pestaña «Exportar». No saltearse ese paso. Algunos paneles como cPanel o Plesk ofrecen además un asistente de «Reparar base de datos» dentro de la sección de MySQL; échale un vistazo si lo tienes disponible.

Qué hacer si el problema viene del servidor de hosting

¿Las credenciales están bien y las tablas están íntegras? Entonces el problema está casi con seguridad en el servidor. Los escenarios que más me he encontrado (y que se repiten en foros y tickets de soporte) son estos:

• Servidor MySQL detenido o sobrecargado: un pico de tráfico, un plugin mal optimizado o consultas pesadas pueden agotar la memoria del servicio. Comprueba el estado del servidor en el panel de tu hosting o mediante una página de prueba con phpinfo().
• Límite de conexiones simultáneas alcanzado: en planes compartidos, el parámetro max_user_connections suele ser restrictivo. Si tu web ha crecido, puede que necesites un plan superior.
• Host de base de datos incorrecto: ojo con esto, porque no todos los proveedores usan localhost. Hay quien configura mysql.tudominio.com u otro host distinto. Verifica el dato en tu panel.
• Corrupción del disco o mantenimiento programado: en ocasiones el error es pasajero, mientras el proveedor realiza tareas de mantenimiento. Espera unos minutos y prueba de nuevo.

Cuando el origen es el servidor, lo más rápido casi siempre es llamar al soporte. Pero no escribas un «no funciona mi web» y ya. Incluye la hora exacta del error, el mensaje completo, capturas de phpMyAdmin y los cambios recientes que hayas hecho. Cuanta más información, menos idas y venidas. Un hosting serio responde en minutos. En RedServicio, por ejemplo, el soporte 24/7 en español puede revisar el estado de MySQL, los registros del servidor y los límites de tu plan sin esperas, algo que se agradece de verdad cuando tu web está caída y cada minuto cuenta.

Conclusión: prevención y mejores prácticas para evitar este error

El error establishing a database connection asusta al verlo, sí. Pero en la mayoría de los casos se resuelve en pocos minutos si trabajas con método: verificar las credenciales en wp-config.php, comprobar que el servidor MySQL está activo, reparar las tablas corruptas y, si nada funciona, escalar al soporte del hosting. La clave está en no actuar a ciegas. Y en trabajar siempre con copias de seguridad recientes, que es lo que te permite equivocarte sin miedo.

1. Programa copias de seguridad automáticas diarias de archivos y base de datos, almacenadas fuera del servidor.
2. Actualiza WordPress, plugins y temas con regularidad, probando primero en un entorno de staging.
3. Optimiza la base de datos periódicamente: revisa revisiones, transitorios caducados y tablas de plugins desinstalados.
4. Supervisa los recursos de tu plan: si tu tráfico crece, un plan compartido limitado puede provocar caídas por agotamiento de conexiones.
5. Elige un hosting con monitorización proactiva y soporte técnico real, disponible cuando lo necesites.

Al final, la estabilidad de una web depende tanto del mantenimiento como de la infraestructura que hay debajo. Si buscas esa tranquilidad, el hosting de RedServicio incluye servidores optimizados para WordPress, copias de seguridad y soporte 24/7, para que errores como este se resuelvan antes de que tus visitantes lo noten. Con estas herramientas y algo de criterio, el temido «Error establishing a database connection» deja de ser una emergencia. Pasa a ser un incidente menor. Algo que sabes diagnosticar y resolver con calma.