Solucionar 'Error establishing a database connection' en WordPress

¿Qué significa el error "Error establishing a database connection"?

Este es, sin duda, uno de los errores más comunes y a la vez más temidos en el mundo de WordPress. Si estás leyendo esto, es muy probable que hayas intentado acceder a tu sitio web y te hayas encontrado con un mensaje que dice algo como "Error establishing a database connection" o, en español, "Error al establecer la conexión con la base de datos".

Respira hondo. No es el fin del mundo. Este mensaje simplemente indica que tu sitio de WordPress no puede comunicarse con la base de datos donde se almacenan tus publicaciones, páginas, comentarios y configuraciones. Sin esa comunicación, tu sitio no puede cargar nada.

Piensa en tu web como una tienda física. WordPress sería el empleado que atiende, y la base de datos es el almacén donde se guardan todos los productos. Si el empleado no puede abrir la puerta del almacén, no puede mostrarte nada. Eso es exactamente lo que está pasando.

La buena noticia es que, en la mayoría de los casos, este error base de datos tiene una solución sencilla que puedes aplicar tú mismo, incluso sin ser un experto en tecnología. En esta guía, vamos a explorar paso a paso las causas más comunes y cómo solucionarlas. No necesitas ser un programador, solo seguir las instrucciones con calma y paciencia.

Primeros pasos: No entres en pánico y verifica lo básico

Antes de lanzarnos a modificar archivos o configuraciones, es crucial hacer una pequeña comprobación inicial. Muchas veces, la solución es más simple de lo que parece.

1. Revisa si el problema es general o solo tuyo

A veces, el problema no es tu web, sino tu conexión a internet o el caché de tu navegador. Para descartarlo, prueba a acceder a tu sitio desde otro dispositivo (como tu móvil con datos móviles, no con el WiFi de casa) o desde una ventana de incógnito en tu navegador.

[TIP] Si el sitio carga bien en otro dispositivo o en modo incógnito, el problema es local. Prueba a limpiar la caché de tu navegador o reiniciar tu router. Si el error persiste en todos los dispositivos, continúa con los siguientes pasos.

2. Comprueba si el problema es solo en la parte pública o también en el administrador

Intenta acceder a tu panel de administración. Normalmente, la URL es algo como tudominio.com/wp-admin. Si también te da el error, el problema es definitivamente la conexión a base de datos. Si solo falla la parte pública, podría ser un problema de un plugin o tema, pero esto es menos común con este error específico.

Las causas más comunes y sus soluciones

Vamos a desglosar las causas más frecuentes de este error. Las abordaremos de menor a mayor complejidad.

1. Solución rápida: Reiniciar el servidor (o contactar con tu proveedor)

A veces, el servidor donde se aloja tu base de datos se satura o se bloquea temporalmente. Esto puede pasar por un aumento repentino de tráfico o por tareas de mantenimiento del proveedor.

Si tu sitio está en un hosting compartido (la opción más barata y común), no podrás reiniciar el servidor tú mismo. En este caso, la solución es contactar con el soporte técnico de tu proveedor de hosting y preguntar si hay algún problema con el servidor de bases de datos.

[WARNING] Si tienes un servidor privado virtual (VPS) o un servidor dedicado, podrías reiniciarlo desde tu panel de control (como Syspanel, al que accedes a través del puerto 2106). Sin embargo, haz esto solo si te sientes cómodo, ya que reiniciar un servidor puede causar una breve caída de todos los sitios alojados en él.

2. La causa más común: Credenciales incorrectas en `wp-config.php`

Este es el archivo de configuración principal de WordPress. Contiene, entre otras cosas, el nombre de tu base de datos, el usuario, la contraseña y el host (servidor) donde se encuentra.

Si estos datos son incorrectos, WordPress no podrá conectarse. Esto puede pasar después de una migración, una restauración o incluso por un error al escribir la contraseña.

Cómo revisar y corregir `wp-config.php`

Para acceder a este archivo, necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de hosting (como Syspanel, accesible por el puerto 2106).

Conéctate a tu servidor y navega hasta la carpeta raíz de tu instalación de WordPress. Normalmente se llama public_html, htdocs o el nombre de tu dominio.
Busca el archivo wp-config.php.
Descárgalo a tu computadora y ábrelo con un editor de texto plano (como el Bloc de notas de Windows o TextEdit en Mac). No uses procesadores de texto como Word.
Busca las siguientes líneas:

define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_base_datos' );
define( 'DB_HOST', 'localhost' );

Verifica que estos datos sean correctos. Puedes encontrarlos en el panel de control de tu hosting (en la sección de Bases de Datos MySQL).

[WARNING] Asegúrate de que DB_HOST sea correcto. En la mayoría de los hostings compartidos es localhost, pero algunos usan una dirección como mysql.tudominio.com o localhost:3306. Si no estás seguro, contacta con tu proveedor.

Si encuentras un error, corrígelo, guarda el archivo y súbelo de nuevo a tu servidor, sobrescribiendo el existente.

[INFO] Si no sabes cómo usar FTP o acceder al administrador de archivos, te recomiendo buscar en Google "cómo usar FileZilla" o "cómo acceder al administrador de archivos de mi hosting". Es una habilidad básica que te servirá para muchas otras tareas.

3. La base de datos está dañada o corrupta

Otra causa posible es que la propia base de datos esté dañada. Esto puede ocurrir por un fallo del servidor, una actualización interrumpida o incluso un ataque malintencionado.

WordPress tiene una función "oculta" para reparar la base de datos. Para usarla, debes añadir una línea específica a tu archivo wp-config.php.

Cómo activar la reparación automática de la base de datos

Sigue los pasos 1-3 de la sección anterior para editar tu archivo wp-config.php.
Busca la línea que dice:

define( 'WP_DEBUG', false );

Justo antes de esa línea (o después), añade la siguiente línea:

define( 'WP_ALLOW_REPAIR', true );

Guarda el archivo y súbelo a tu servidor.
Ahora, en tu navegador, visita la siguiente URL: tudominio.com/wp-admin/maint/repair.php
Verás una página que te ofrece dos opciones: "Reparar la base de datos" o "Reparar y optimizar la base de datos". Haz clic en el primer botón.
Espera a que el proceso termine. Te mostrará un mensaje de éxito o de error.
MUY IMPORTANTE: Una vez reparada, elimina la línea define( 'WP_ALLOW_REPAIR', true ); de tu archivo wp-config.php. Dejarla activa es un riesgo de seguridad.

[TIP] Si la reparación no funciona, es probable que el daño sea más grave. En ese caso, contacta con tu proveedor de hosting, ya que ellos tienen herramientas más potentes para reparar o restaurar la base de datos desde una copia de seguridad.

4. El host de la base de datos no responde

A veces, el problema no es la configuración, sino que el servidor de la base de datos está caído o no responde. Esto puede deberse a un fallo en el servidor o a un problema de red.

Para comprobarlo, necesitas saber cuál es el host de tu base de datos (el valor de DB_HOST). Como mencionamos antes, suele ser localhost, pero no siempre es así.

Cómo comprobar si el host responde

Esta es una prueba un poco más técnica, pero es muy útil.

Abre la terminal de tu computadora (en Windows, es el "Símbolo del sistema" o "PowerShell"; en Mac, es la app "Terminal").
Escribe el siguiente comando y presiona Enter:

ping tuhost.com

Reemplaza tuhost.com con el valor de tu DB_HOST. Por ejemplo, si tu DB_HOST es localhost, este test no te servirá de mucho, pero si es mysql.tudominio.com, pruébalo.

Si ves respuestas como 64 bytes from..., el servidor está activo y responde. Si ves Request timeout o Destination Host Unreachable, el servidor no es accesible.

Si el servidor no responde, el problema está en la infraestructura de tu hosting. No hay nada que puedas hacer tú, salvo contactar con el soporte técnico y reportar el problema.

5. Conflictos con plugins o temas (menos común)

Aunque es menos frecuente, un plugin o tema mal configurado puede causar este error. Esto suele pasar después de instalar o actualizar un plugin que interactúa con la base de datos de una manera agresiva.

Cómo descartar un conflicto de plugins

Para ello, necesitas desactivar todos los plugins. Puedes hacerlo desde el administrador de archivos de tu hosting o por FTP.

Accede a la carpeta de tu instalación de WordPress.
Busca la carpeta wp-content.
Dentro, busca la carpeta plugins.
Renombra la carpeta plugins a plugins_backup. (No la borres, solo renómbrala).

Esto desactivará todos los plugins a la vez. Ahora, intenta acceder a tu sitio.

Si el error desaparece, el problema es uno de los plugins. Para encontrarlo, renombra la carpeta de nuevo a plugins y luego ve renombrando cada subcarpeta de plugin individualmente, una a una, comprobando tu sitio tras cada cambio. Cuando el error aparezca, habrás encontrado al culpable.
Si el error persiste, el problema no es de plugins. Renombra la carpeta a plugins de nuevo.

[INFO] Si el problema no son los plugins, podría ser el tema. Para descartarlo, cambia el nombre de la carpeta wp-content/themes/tu-tema-activo a wp-content/themes/tu-tema-activo_backup. Si el error desaparece, el problema es el tema. Puedes reinstalarlo o contactar con su desarrollador.

Preguntas Frecuentes (FAQ)

¿Puedo perder mis datos si borro el archivo `wp-config.php`?

No, el archivo wp-config.php no contiene tus datos (publicaciones, páginas, etc.). Solo contiene la configuración de conexión. Si lo borras, WordPress intentará crear uno nuevo, pero es mejor que nunca lo borres. Simplemente edítalo con cuidado.

¿Qué es el puerto 2106 y Syspanel?

Syspanel es el nombre que recibe el panel de control de hosting que utilizamos en nuestros servidores. Es una herramienta que te permite gestionar tus sitios web, bases de datos, cuentas de correo y mucho más. Para acceder a él, debes abrir tu navegador y escribir la dirección de tu servidor seguida de dos puntos y el puerto 2106. Por ejemplo: https://tu-servidor.com:2106. Ahí podrás encontrar la información de tu base de datos y el administrador de archivos.

¿Con qué frecuencia debo hacer copias de seguridad de mi base de datos?

Idealmente, deberías hacer una copia de seguridad de tu base de datos al menos una vez por semana. Si actualizas tu sitio con frecuencia (nuevas entradas, plugins, etc.), te recomiendo hacerlo a diario. La mayoría de los hostings ofrecen copias de seguridad automáticas, pero es bueno tener una copia propia en un lugar seguro (como tu computadora o un servicio de almacenamiento en la nube).

El error sigue apareciendo después de probar todo, ¿qué hago?

Si has seguido todos los pasos anteriores y el error persiste, es hora de contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver exactamente qué está fallando. Proporciónales toda la información que tengas: qué pasos has seguido, qué has comprobado, y cualquier mensaje de error adicional que veas. Esto les ayudará a diagnosticar el problema mucho más rápido.

Conclusión y consejos finales

El error "Error establishing a database connection" es un problema serio, pero casi siempre solucionable. Hemos visto que las causas más comunes son errores de configuración en wp-config.php, problemas con el servidor de la base de datos o una base de datos dañada.

Recuerda el orden lógico para solucionarlo:

Verifica lo básico: Reinicia tu navegador, prueba con otro dispositivo.
Contacta a tu proveedor: Pregunta si hay una caída general del servicio.
Revisa wp-config.php: Asegúrate de que las credenciales de la base de datos sean correctas.
Intenta la reparación automática: Activa WP_ALLOW_REPAIR.
Comprueba el servidor de la base de datos: Haz un ping al host.
Descarta conflictos: Desactiva todos los plugins y el tema.

[WARNING] Siempre que vayas a modificar archivos importantes como wp-config.php, es recomendable hacer una copia de seguridad del archivo original antes de tocarlo. Así, si algo sale mal, puedes restaurarlo fácilmente.

Espero que esta guía te haya sido de gran ayuda. No te desanimes si no lo resuelves a la primera; la práctica hace al maestro. Con paciencia y siguiendo estos pasos, tu sitio web de WordPress volverá a estar en línea en poco tiempo.