Te levantas, abres tu web y te encuentras el mensaje que ningún dueño de WordPress quiere ver: «Error al establecer una conexión con la base de datos» o su versión en inglés «Error establishing a database connection». No es un aviso menor. Tu web está caída, Google puede estar rastreando errores y tú pierdes visitas y ventas cada minuto.
He pasado por esto más veces de las que me gustaría reconocer, y te voy a contar exactamente qué hago yo, sin rodeos y sin teorías de manual.
Lo primero que tienes que tener claro es que este error casi nunca es «de WordPress». Es de la comunicación entre WordPress y MySQL/MariaDB. Y en el 90% de los casos el culpable está en el archivo wp-config.php, en el servidor de base de datos o en un plugin que se ha pasado de listo.
Qué significa realmente el error de conexión a la base de datos en WordPress
WordPress no guarda el contenido en archivos. Lo guarda en una base de datos MySQL. Cuando alguien visita tu web, WordPress pide los datos a esa base de datos usando unas credenciales que están en wp-config.php: nombre de la base de datos, usuario, contraseña y host.
Si cualquiera de esos cuatro datos falla, o si el servidor de base de datos no responde, aparece el error de conexión a la base de datos de WordPress. Punto. No hay magia.
Antes de tocar nada, haz una copia de seguridad de wp-config.php y de la base de datos. Si la cagas, al menos podrás volver atrás. Esto no es opcional.
Comprueba wp-config.php: el 70% de las soluciones están aquí
Abre wp-config.php por FTP o desde el gestor de archivos de tu hosting. Busca estas líneas:
- DB_NAME: el nombre exacto de tu base de datos.
- DB_USER: el usuario de MySQL.
- DB_PASSWORD: la contraseña.
- DB_HOST: casi siempre localhost, pero en algunos hostings es una IP o un hostname distinto.
Un espacio en blanco de más al final de una contraseña, una comilla mal cerrada o un acento en el nombre de la base de datos tiran la web entera. Yo he visto casos donde el hosting cambió el usuario de MySQL tras una migración y el cliente no lo sabía. Revisa esto con lupa.
Si tienes dudas, entra en phpMyAdmin y confirma que la base de datos existe y que el usuario tiene permisos sobre ella. Si no existe, créala y asigna el usuario correcto.
Errores de sintaxis y espacios invisibles que rompen la conexión
Hay algo que casi nadie menciona y que a mí me ha salvado más de una vez: los espacios en blanco o saltos de línea después de la etiqueta de cierre de PHP en wp-config.php. Ese pequeño espacio se envía como salida al navegador y puede provocar el error de conexión.
La solución es simple: elimina la etiqueta de cierre ?> al final del archivo o asegúrate de que no hay nada después. También revisa que no haya caracteres raros por copiar y pegar desde un editor con formato.
El servidor de base de datos está caído o sobrecargado
No siempre es culpa tuya. A veces MySQL se cae en el hosting, sobre todo en planes compartidos baratos donde cientos de webs comparten el mismo servidor. Si tu web funciona y de repente deja de hacerlo sin que hayas tocado nada, sospecha del hosting.
Entra en el panel de tu proveedor y mira si hay incidencias. Si no ves nada, abre un ticket. Un buen soporte te lo dice en minutos. Si tu hosting tarda horas en responder o te da largas, plantéate seriamente cambiar a un VPS o servidor dedicado. En 2026, con lo que cuesta un VPS decente, no tiene sentido seguir en un compartido que se cae cada dos semanas.
Plugins y temas que sabotean la conexión a la base de datos
Un plugin mal programado o desactualizado puede consumir todas las conexiones disponibles a MySQL. Cuando el límite se agota, WordPress ya no puede conectar. El síntoma típico es que la web va lenta durante unos minutos y luego aparece el error.
Para descartarlo, renombra la carpeta plugins por FTP. Si la web vuelve, ya sabes por dónde van los tiros. Luego ve reactivando uno a uno. Lo mismo con el tema: cambia temporalmente a un tema por defecto como Twenty Twenty-Four y comprueba si el error desaparece.
Ojo con los plugins de caché y los de seguridad. Son los que más problemas de conexión a la base de datos generan porque hacen consultas extra o bloquean peticiones legítimas.
El archivo .htaccess también puede estar detrás del fallo
Parece mentira, pero un .htaccess corrupto puede redirigir mal las peticiones y hacer que WordPress no encuentre su base de datos. Renómbralo a .htaccess_old y recarga la web. Si funciona, vuelve a generar uno limpio desde Ajustes > Enlaces permanentes.
Reparar la base de datos de WordPress desde dentro de WordPress
Existe una función poco conocida: añadir esta línea en wp-config.php:
define(‘WP_ALLOW_REPAIR’, true);
Después visita tudominio.com/wp-admin/maint/repair.php. WordPress te ofrecerá reparar y optimizar la base de datos. Es útil cuando hay tablas corruptas, algo habitual tras una actualización fallida o un corte de luz en el servidor.
Cuando termines, elimina esa línea o ponla en false. Si la dejas activa, cualquiera puede ejecutar la reparación y eso es un agujero de seguridad importante.
Corrupción de tablas: el error que se disfraza de conexión
A veces el error de conexión a la base de datos de WordPress no es de conexión, sino de tablas dañadas. Lo compruebas entrando en phpMyAdmin y ejecutando un CHECK TABLE sobre las tablas de WordPress. Si alguna devuelve error, usa REPAIR TABLE.
Las tablas que más se corrompen son wp_options, wp_posts y wp_postmeta. Si no puedes repararlas desde phpMyAdmin, tu hosting debería poder hacerlo desde el servidor.
Seguridad: no dejes la puerta abierta mientras arreglas esto
Mientras solucionas el error, no pierdas de vista la seguridad. Contraseñas fuertes en MySQL, usuario de base de datos distinto al de la administración, y todo actualizado. Un WordPress desactualizado es la puerta de entrada favorita para inyecciones SQL que acaban corrompiendo la base de datos.
Y si usas hosting compartido, asume que el vecino de al lado puede estar minando criptomonedas con los recursos de tu servidor. Eso también tumba MySQL. Migrar a un VPS con recursos dedicados es la mejor decisión técnica que puedes tomar si tu web genera ingresos.
Cuándo dejar de pelearte y pedir ayuda profesional
Si has revisado wp-config.php, descartado plugins, comprobado el servidor y sigues con el error, no pierdas más horas. Un desarrollador con acceso SSH te lo resuelve en menos de una hora. Foros como el de WordPress.org o Stack Exchange pueden ayudarte, pero si tu web está caída y factura, el tiempo es dinero.
Mi consejo final: documenta cada cambio que hagas. Apunta qué tocaste y cuándo. Así, si el error vuelve, sabrás exactamente por dónde empezar. Y monta un sistema de backups automáticos diarios. Un día te salvará el negocio.
