Solucionar Error de Conexión a Base de Datos en WordPress

¿Te ha pasado que intentas entrar a tu sitio web y, en lugar de tu página, aparece un mensaje en blanco que dice "Error establishing a database connection"? No te preocupes, no has roto nada. Es uno de los errores más comunes en WordPress y, con esta guía paso a paso, lo vas a resolver tú mismo, aunque no seas un experto en informática.

En este instructivo completo, vamos a destripar este problema. Te explicaré qué significa exactamente, por qué ocurre y, lo más importante, te daré 8 soluciones prácticas ordenadas de la más fácil a la más compleja. Al final, también responderé preguntas frecuentes. Tómate un respiro, porque esto tiene solución.

¿Qué significa exactamente "Error establishing a database connection"?

Para entenderlo fácil, piensa en tu web como una tienda física.

Tu WordPress (los archivos del tema, los plugins, el código) es el escaparate y los muebles de la tienda.

Tu Base de Datos (MySQL/MariaDB) es el almacén trasero, donde guardas todos los productos (tus artículos, páginas, comentarios, usuarios y ajustes).

El mensaje de error "Error establishing a database connection" (o "error conexión base de datos wordpress") significa que el escaparte está montado, pero la puerta del almacén está cerrada con llave o la llave no es la correcta. WordPress no puede llegar a sus datos para mostrarte nada, así que se rinde y te muestra ese mensaje.

Este error no es un problema de diseño ni de contenido; es un problema de comunicación entre dos partes de tu hosting. La buena noticia es que, en el 80% de los casos, se arregla en menos de 5 minutos.

Antes de empezar: Prepara tu kit de herramientas

Para solucionar esto, necesitarás acceso a dos cosas:

Tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.). Ahí podrás ver los archivos y las bases de datos. Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106).
Acceso a tu gestor de archivos (puede estar dentro del panel de control) o un cliente FTP como FileZilla.

No te asustes, solo necesitas saber navegar por carpetas. Vamos a ello.

Solución 1: El clásico "¿Lo has apagado y encendido?" (Reiniciar servicios)

A veces, el servidor de base de datos (MySQL/MariaDB) se satura o se bloquea temporalmente. Es como cuando tu ordenador se queda congelado: no hace falta formatearlo, solo reiniciarlo.

Pasos a seguir:

Accede a tu panel de control de hosting (por ejemplo, Syspanel en el puerto 2106, o cPanel).
Busca una sección llamada "Servicios", "Administrador de servicios" o "Service Manager".
Busca el servicio llamado MySQL o MariaDB.
Haz clic en el botón de "Reiniciar" o "Restart".

Espera un minuto y recarga tu sitio web. Esta es la solución más rápida y, en muchas ocasiones, la definitiva.

Solución 2: Revisar las credenciales en `wp-config.php` (El archivo clave)

Este es el archivo de configuración principal de WordPress. Es como la llave maestra que conecta el escaparate con el almacén. Si las contraseñas o los nombres han cambiado, la conexión falla.

¿Cómo hacerlo?

Ve a tu Gestor de Archivos en el panel de control, o conéctate por FTP.
Navega hasta la carpeta raíz de tu WordPress (normalmente public_html, htdocs o el nombre de tu dominio).
Busca el archivo llamado wp-config.php. ¡Cuidado! No lo confundas con wp-config-sample.php. Abre el primero con el editor de texto del panel (clic derecho -> Editar).
Busca las líneas que se ven así:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );

/** MySQL database username */
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Verifica que estos datos (nombre, usuario, contraseña y host) sean exactamente los correctos. A veces, al cambiar de hosting o de plan, estos datos cambian y no los actualizamos.

¿Cómo saber cuáles son los correctos?

Ve a tu panel de control y busca "Bases de Datos MySQL" o "Base de Datos".
Ahí verás una lista de bases de datos y los usuarios asociados a ellas.
Compara los nombres. Si no recuerdas la contraseña, puedes cambiarla desde el mismo panel (botón "Cambiar contraseña").
Actualiza el archivo wp-config.php con los datos correctos y guarda los cambios.

[TIP] No cambies la contraseña en el panel y en el archivo a la vez. Primero cámbiala en el panel, luego copia esa nueva contraseña al archivo wp-config.php. Así evitarás errores de escritura.

Solución 3: Reparar la base de datos (El "tune-up" de WordPress)

WordPress tiene una herramienta secreta para arreglar bases de datos corruptas o con errores internos. No la verás en el menú, pero puedes activarla manualmente.

Pasos:

Ve a tu Gestor de Archivos y abre el archivo wp-config.php de nuevo.
Busca la línea que dice:

define( 'WP_DEBUG', false );

Justo antes de esa línea (o después, da igual), añade esta línea nueva:

define( 'WP_ALLOW_REPAIR', true );

Guarda el archivo.
Ahora, en tu navegador, ve a esta dirección: www.tu-dominio.com/wp-admin/maint/repair.php
Verás una página con dos botones. Haz clic en "Reparar base de datos" (Repair Database). Si no funciona, haz clic en "Reparar y Optimizar".

Este proceso es seguro y no borra nada. Solo revisa las tablas y corrige pequeños fallos.

[WARNING] Cuando termines, es obligatorio que borres la línea define( 'WP_ALLOW_REPAIR', true ); que añadiste. Si la dejas, cualquier persona podría acceder a esa herramienta de reparación y causar problemas de seguridad. Bórrala y guarda el archivo.

Solución 4: El problema está en el Hosting (Hostname incorrecto)

A veces, el problema no es la contraseña, sino la dirección del servidor de base de datos (el DB_HOST).

En la mayoría de hostings compartidos, el valor correcto es localhost.
Pero en otros (como algunos planes de WP Engine, Kinsta o servidores VPS configurados de forma especial), el host puede ser algo como localhost:/var/run/mysqld/mysqld.sock o una dirección IP como 127.0.0.1 o un subdominio tipo db.tu-dominio.com.

¿Cómo saberlo?

Revisa los correos de bienvenida de tu proveedor de hosting. A menudo incluyen estos datos.
Si usas Syspanel, ve a la sección de bases de datos y observa los detalles; a veces te indica el host exacto.
Prueba a cambiar localhost por 127.0.0.1 y guarda. A veces ese simple cambio resuelve el problema por temas de IPv4 vs IPv6.

Si has probado esto y sigue fallando, lo más probable es que el servidor de bases de datos esté caído (vuelve a la Solución 1) o que el problema sea más profundo (sigue leyendo).

Solución 5: Ataque de hackers o archivos corruptos (Reinstalar núcleo)

Si has verificado las credenciales y el host, y sigue sin funcionar, es posible que un plugin malicioso o un hackeo haya corrompido los archivos principales de WordPress.

Plan de acción:

Descarga la última versión de WordPress en español desde es.wordpress.org.
Descomprime el archivo en tu ordenador.
Sube solo la carpeta wp-admin y wp-includes desde el archivo descomprimido a tu hosting, sobrescribiendo las carpetas existentes (vía FTP o Gestor de Archivos).
No subas la carpeta wp-content ni el wp-config.php del archivo descargado, porque eso borraría tus plugins, temas y configuración.

Esto reemplaza los archivos del sistema por unos limpios, sin tocar tu contenido. Es una cura eficaz si hay archivos corruptos.

Solución 6: El plugin o tema conflictivo (Modo de recuperación)

A veces, un plugin mal codificado intenta hacer una consulta a la base de datos de forma incorrecta y la bloquea. Como no puedes entrar al panel de administración, tendrás que hacerlo por FTP.

Pasos:

Conéctate por FTP o al Gestor de Archivos.
Ve a la carpeta wp-content.
Renombra la carpeta plugins a plugins_viejo. (Solo cambia el nombre, no la borres).
Recarga tu web. Si el error desaparece, el problema era un plugin.
Entra a tu panel de administración (ahora debería funcionar). Ve a Plugins y verás que están desactivados (porque la carpeta tiene otro nombre).
Ve a wp-content y renombra plugins_viejo de vuelta a plugins. WordPress detectará los plugins y te pedirá que los actives uno a uno.
Actívalos de uno en uno, recargando la web después de cada activación. Cuando encuentres el que da error, lo sabrás. Elimínalo o busca una alternativa.

Si renombrar plugins no funciona, intenta renombrar la carpeta themes a themes_viejo. Esto activará un tema por defecto y descartará problemas de diseño.

Solución 7: Límite de memoria PHP agotado

Aunque es menos común, un error de conexión a veces se disfraza de un problema de memoria. Si la base de datos es grande o el servidor tiene poca memoria PHP, la conexión se corta.

Solución rápida:

Abre tu archivo wp-config.php.
Añade esta línea justo antes de la línea /* That's all, stop editing! */:

define( 'WP_MEMORY_LIMIT', '256M' );

Guarda y recarga.

Si esto no funciona, revisa en tu panel de control si puedes aumentar la versión de PHP (por ejemplo, de 7.4 a 8.1). Las versiones más nuevas son más rápidas y eficientes.

Solución 8: Contactar con el soporte técnico (La opción "nuclear")

Si has llegado hasta aquí y nada funciona, el problema no está en tu WordPress, sino en el servidor donde está alojado tu sitio.

Qué hacer:

Ve a la sección de "Soporte" o "Tickets" de tu proveedor de hosting.
Envía un mensaje claro y conciso. Incluye esta información:
- "Mi sitio muestra 'error establishing database connection'".
- "Ya he verificado las credenciales en wp-config.php".
- "He reiniciado el servicio MySQL desde el panel".
- "El error persiste".

Con esos datos, el soporte técnico sabrá que ya has hecho tus deberes y se centrará en revisar el servidor, los logs de error y la configuración de red de MySQL.

Preguntas Frecuentes (FAQ)

¿Este error puede dañar mi posicionamiento SEO?

Sí, si el error dura mucho tiempo (días), Google puede interpretar que tu web está caída y reducir tu posicionamiento en los resultados de búsqueda. Por eso es crucial solucionarlo rápido. Una vez que la web vuelve a estar activa, el SEO suele recuperarse con el tiempo.

¿Pierdo mis datos si se cae la base de datos?

No. El error de conexión solo significa que WordPress no puede leer la base de datos, pero los datos siguen ahí, intactos en el servidor. No estás perdiendo artículos ni comentarios.

¿Por qué me piden el puerto 2106 para Syspanel?

Syspanel (el panel de control que antes se llamaba HestiaCP) usa por defecto el puerto 2106 para su interfaz web de administración. Es una medida de seguridad para que no sea tan fácil de encontrar como el típico puerto 2083 de cPanel. Si tu hosting usa Syspanel, recuerda añadir :2106 al final de la URL de acceso.

¿Qué significa "arreglar mysql wordpress"?

Significa solucionar los problemas de comunicación entre el motor de base de datos MySQL y el software de WordPress. Las soluciones que te he dado (reiniciar MySQL, verificar credenciales, reparar tablas) son precisamente eso: arreglar MySQL para que WordPress funcione.

¿Es lo mismo un error 500 que este error de conexión?

No. Un error 500 es un error general del servidor. El "Error establishing a database connection" es un error específico que indica que el servidor web está bien, pero la base de datos no está accesible. La solución es diferente.

¿Debo contratar a un programador?

No necesariamente. La mayoría de las soluciones de esta guía son administrativas (clic en botones, editar un archivo de texto). Solo si has agotado todas las opciones y el soporte de tu hosting no te ayuda, podrías considerar contratar a un profesional de WordPress para que investigue los logs del servidor más a fondo.

Resumen final: No entres en pánico. Este error es un dolor de cabeza, pero es temporal y solucionable. Sigue las soluciones en orden. La número 1 (reiniciar) y la número 2 (verificar credenciales) resolverán el 90% de los casos. Mucha suerte, y si te ha funcionado, ¡comparte esta guía con otro amigo que tenga problemas con su web!