Que WordPress te suelte el error de establecimiento de conexión con la base de datos da un mal rato de los que no se olvidan. La web entera, caída. Y en su lugar, una pantalla en blanco con un mensaje que dice que no se puede conectar con la base de datos. Lo primero que conviene saber: en la mayoría de los casos esto se arregla en pocos minutos. Suele bastar con revisar las credenciales, el estado del servidor MySQL o la integridad de la propia base. Aquí te contamos qué significa exactamente el error, por qué aparece y cómo resolverlo paso a paso. ¿Prefieres que lo revise alguien con experiencia? En RedServicio (redservicio.net) nos enfrentamos a esta incidencia a diario.
¿Qué significa el error de establecimiento de conexión con la base de datos en WordPress?
WordPress no guarda nada en archivos sueltos. Todo el contenido del sitio (entradas, páginas, usuarios, ajustes de plugins y temas) vive en una base de datos MySQL o MariaDB. Cada vez que alguien visita tu web, PHP se conecta a esa base usando las credenciales definidas en el archivo wp-config.php, recupera la información y genera la página.
Pues bien. Cuando aparece el mensaje «Error establishing a database connection» (o su traducción «Error de establecimiento de conexión con la base de datos»), lo que ha pasado es que WordPress intentó conectarse y el servidor MySQL rechazó la conexión, o directamente no respondió. Resultado: el sitio no puede mostrar nada. Ni la parte pública ni el panel de administración.
Conviene distinguir dos escenarios, porque no apuntan al mismo problema:
- Error solo en el frontal o solo en wp-admin: suele indicar una base de datos corrupta o una tabla dañada, más que un problema de credenciales.
- Error total (sitio y administración caídos): esto apunta a credenciales incorrectas, servidor de base de datos caído o problemas de recursos en el hosting.
Causas más comunes del error de conexión a la base de datos
Después de analizar cientos de casos, estas son las causas que aparecen una y otra vez:
- Credenciales incorrectas en wp-config.php: la causa número uno, sin discusión. Suele ocurrir tras migrar la web a otro servidor, cambiar el nombre de la base de datos o actualizar la contraseña de MySQL desde el panel del hosting.
- Servidor MySQL caído o saturado: un pico de tráfico, un plugin mal optimizado o consultas pesadas pueden agotar la memoria del proceso de base de datos y tumbarlo temporalmente.
- Base de datos o tablas corruptas: un corte de luz en el servidor, una actualización interrumpida o un plugin defectuoso pueden dañar tablas críticas como wp_options o wp_posts.
- Límites de recursos del hosting alcanzados: en planes compartidos, superar el número máximo de conexiones simultáneas o el límite de RAM genera este error de forma intermitente. A veces sí, a veces no. Eso ya es una pista.
- Host de base de datos mal configurado: usar «localhost» cuando el proveedor exige un host externo (por ejemplo, mysql.midominio.com) impide la conexión.
Cómo revisar y corregir las credenciales en wp-config.php
Empezamos por el archivo wp-config.php, que está en la raíz de tu instalación de WordPress. Accede por FTP (con FileZilla, por ejemplo) o mediante el administrador de archivos de tu hosting y busca estas líneas:
- define( ‘DB_NAME’, ‘nombre_base_datos’ ); — el nombre exacto de la base de datos.
- define( ‘DB_USER’, ‘usuario_mysql’ ); — el usuario con permisos sobre esa base.
- define( ‘DB_PASSWORD’, ‘contraseña’ ); — su contraseña.
- define( ‘DB_HOST’, ‘localhost’ ); — el servidor donde corre MySQL.
Ahora compara cada valor con los datos reales que encontrarás en el panel de tu hosting (en cPanel, dentro de «Bases de datos MySQL»; en Plesk, en «Bases de datos»). Y ojo con estos detalles, que son los que más despistan:
- Espacios accidentales antes o después de las comillas.
- Contraseñas con caracteres especiales (como @, # o &) que hayan cambiado al copiarlas.
- Un host de base de datos distinto de «localhost» si el proveedor lo requiere.
¿Has editado algún valor? Guarda el archivo, súbelo de nuevo y recarga la web. Si las credenciales eran el problema, el sitio debería volver a funcionar al instante. Y si prefieres no tocar nada, en RedServicio (redservicio.net) dispones de soporte profesional para revisar y reparar este o cualquier otro error de WordPress sin riesgo de perder datos.
Reparar una base de datos corrupta desde phpMyAdmin
Puede que las credenciales estén bien puestas y aún así el error de establecimiento de conexión siga ahí. En ese caso, el siguiente sospechoso habitual es una base de datos corrupta. Suele pasar por un apagado brusco del servidor, un fallo de disco o una actualización de plugin que se interrumpió a mitad de escritura.
Activar la reparación automática de WordPress
WordPress trae de serie un mecanismo de reparación. Abre el archivo wp-config.php y añade esta línea antes del comentario que indica «stop editing»:
define('WP_ALLOW_REPAIR', true);
Luego visita https://tudominio.com/wp-admin/maint/repair.php. Te aparecerán dos opciones: reparar la base de datos y repararla optimizándola además. Un detalle importante: el proceso no pide iniciar sesión. Así que cuando termines, borra la línea de wp-config.php sin falta. Si no, cualquiera podría ejecutar la reparación en tu web.
Reparación manual con phpMyAdmin
¿La reparación automática no bastó? Entonces toca ir a phpMyAdmin, desde el panel de tu hosting:
- Selecciona la base de datos de tu instalación en el panel lateral.
- Marca todas las tablas de la lista.
- En el desplegable de acciones, elige Repair table (Reparar tabla).
- Si el error sigue ahí, repite la operación con Optimize table.
Por experiencia, las tablas que más sufren son wp_options y wp_posts: son las que aguantan más escrituras. Si solo una falla, puedes repararla de forma aislada sin tocar el resto. Y en casos graves, lo mejor suele ser restaurar un backup reciente desde phpMyAdmin, importando el archivo .sql de la copia de seguridad más limpia que tengas.
Qué hacer si el problema viene del servidor de hosting
Habrá veces que ni las credenciales ni la base de datos estén en falta. Si ya verificaste ambas cosas sin éxito, el fallo casi seguro está en la infraestructura del propio hosting. Estas son las comprobaciones clave:
- El servidor MySQL está caído: si otras webs del mismo servidor fallan igual, contacta con el soporte del hosting de inmediato. Es un problema que solo ellos pueden resolver.
- Límite de conexiones agotado: algunos planes limitan el número de conexiones simultáneas a MySQL. Con un pico de tráfico, las conexiones se saturan y WordPress muestra justo este error.
- Recursos insuficientes: poca memoria PHP o un límite bajo de max_connections en MySQL provocan caídas intermitentes. Las intermitentes son las peores de diagnosticar, dicho sea de paso.
- Host incorrecto: si la base de datos está en un servidor remoto, el valor de DB_HOST debe apuntar a esa dirección, no a «localhost».
Antes de abrir el ticket de soporte, recopila lo que pueda servir: la hora exacta del error, mensajes del registro de errores PHP y una captura del mensaje completo. Al equipo técnico le ahorra horas de trabajo, y a ti, horas de espera.
Conclusión: evitar futuros errores de conexión con la base de datos
El error de establecimiento de conexión con la base de datos asusta, lo sé. Pero en la mayoría de los casos se resuelve en pocos minutos si sigues un orden lógico: verificar las credenciales en wp-config.php, reparar la base de datos si está corrupta y escalar al hosting cuando el problema venga del servidor.
Para que no se repita, hay varias medidas que ayudan:
- Realiza copias de seguridad automáticas diarias de archivos y base de datos.
- Mantén WordPress, plugins y temas siempre actualizados.
- Instala un plugin de monitorización de disponibilidad que te avise al instante.
- Contrata un plan de hosting con recursos acordes al tráfico real de tu web.
- Documenta las credenciales de la base de datos en un lugar seguro tras cualquier migración.
Y si en algún momento prefieres no lidiar con el problema, en RedServicio (redservicio.net) encontrarás ayuda profesional para diagnosticar y reparar este error, restaurar tu web con seguridad y blindarla frente a futuras caídas.
