Error establishing a database connection WordPress: Solución

¡Hola! Soy tu técnico de soporte amigable. Entiendo que ver el mensaje "Error establishing a database connection" en tu web WordPress puede ser frustrante, especialmente cuando tienes visitas o estás trabajando en tu sitio. No te preocupes, este es uno de los errores más comunes y, en la mayoría de los casos, tiene solución rápida.

Vamos a desglosar este problema paso a paso. El error significa que WordPress no puede comunicarse con tu base de datos. Es como si tu web intentara abrir un archivador (la base de datos) pero no encuentra la llave correcta o el archivador está cerrado. Te guiaré por las causas más frecuentes y cómo solucionarlas, usando herramientas como cPanel o Syspanel (recuerda, si usas Syspanel, el acceso es por el puerto 2106).

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

Antes de lanzarnos a solucionarlo, es bueno entender las posibles causas. Generalmente, el problema viene de uno de estos cuatro escenarios:

Credenciales incorrectas en el archivo wp-config.php. Es como tener mal la contraseña del archivador.
El servidor de base de datos está caído o sobrecargado. El archivador está cerrado con llave.
La base de datos ha sido corrompida o eliminada. El archivador ya no existe.
Problemas con el plugin o tema que forzó un cambio en la conexión. Algo movió la llave de lugar.

Vamos a revisar cada una.

Solución 1: Verificar y corregir el archivo wp-config.php

Este es el primer lugar donde debes mirar. El archivo wp-config.php contiene las credenciales de tu base de datos: nombre, usuario, contraseña y servidor.

¿Cómo acceder al archivo?

Puedes hacerlo desde el panel de control de tu hosting o mediante FTP.

Desde cPanel:

Ingresa a tu cPanel.
Busca la sección Archivos y haz clic en Administrador de archivos.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o www).
Busca el archivo wp-config.php. Haz clic derecho y selecciona Editar.

Desde Syspanel (puerto 2106):

Abre tu navegador y escribe tu-dominio.com:2106.
Inicia sesión con tu usuario y contraseña de Syspanel.
Ve a Archivos > Administrador de archivos.
Localiza la carpeta de tu sitio y luego el archivo wp-config.php.

¿Qué debes revisar?

Dentro del archivo, busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_tu_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_tu_base_de_datos');
define('DB_HOST', 'localhost');

Compara estos datos con los de tu base de datos real. Puedes encontrar la información correcta en:

cPanel: Ve a Bases de datos > Bases de datos MySQL. Ahí verás las bases de datos y los usuarios asociados.
Syspanel: Ve a Bases de datos > Bases de datos MySQL. También verás la lista.

[TIP] Si no recuerdas la contraseña, puedes crear una nueva desde el panel. En cPanel, ve a Bases de datos MySQL, busca el usuario y haz clic en Cambiar contraseña. Luego actualiza el valor en wp-config.php.

Importante: A veces el servidor de la base de datos no es localhost. Puede ser algo como mysql.tudominio.com o localhost:3306. Si tu hosting te ha dado un host específico, úsalo.

Solución 2: Reparar la base de datos (si está corrupta)

A veces la base de datos se daña por un corte de energía, un plugin conflictivo o una actualización fallida. WordPress tiene una herramienta de reparación integrada.

Activar el modo de reparación

Abre tu archivo wp-config.php (como vimos en la Solución 1).
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, agrega esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
En tu navegador, visita: tudominio.com/wp-admin/maint/repair.php
Verás dos opciones: Reparar base de datos y Reparar y optimizar base de datos. Te recomiendo seleccionar la segunda.
WordPress intentará arreglar cualquier error en las tablas.

[WARNING] Una vez terminada la reparación, ELIMINA LA LÍNEA que agregaste en wp-config.php. Si la dejas, cualquier persona podría acceder a la herramienta de reparación, lo cual es un riesgo de seguridad.

Solución 3: Verificar el estado del servidor de base de datos

A veces el problema no es tuyo, sino del servidor. El servidor de base de datos (MySQL/MariaDB) puede estar caído o sobrecargado.

¿Cómo comprobarlo?

Desde cPanel: Busca la sección Estado del servidor o Información del servidor. Si no ves nada, contacta a tu proveedor de hosting.
Desde Syspanel: Ve a Estado del servidor o Servicios. Busca el estado de MySQL/MariaDB. Si está en rojo o detenido, puedes intentar reiniciarlo desde el mismo panel (normalmente hay un botón de Reiniciar).
Pregunta a tu hosting: Si no tienes acceso a estas herramientas, envía un ticket de soporte a tu empresa de hosting. Diles: "Mi sitio muestra 'Error establishing a database connection' y necesito que verifiquen si el servicio MySQL está funcionando".

[INFO] Si el servidor está caído, la solución suele ser esperar a que el equipo de hosting lo reinicie. En algunos casos, puedes reiniciarlo tú mismo desde el panel.

Solución 4: Restaurar la base de datos desde una copia de seguridad

Si la base de datos ha sido eliminada accidentalmente o está tan dañada que la reparación no funciona, tendrás que restaurarla desde una copia de seguridad.

¿Cómo hacerlo?

Desde cPanel:

Ve a Archivos > Administrador de archivos y busca tu copia de seguridad (normalmente un archivo .sql).
Ve a Bases de datos > phpMyAdmin.
Selecciona tu base de datos (la que aparece en wp-config.php).
Haz clic en la pestaña Importar.
Selecciona el archivo .sql de tu copia y haz clic en Continuar.

Desde Syspanel (puerto 2106):

Ve a Bases de datos > phpMyAdmin.
Selecciona tu base de datos.
Haz clic en Importar y sube tu archivo .sql.

[WARNING] Si no tienes una copia de seguridad reciente, contacta a tu hosting de inmediato. Algunos proveedores tienen copias de seguridad automáticas que pueden restaurar.

Solución 5: Desactivar plugins o temas conflictivos (si puedes acceder al panel)

A veces un plugin o tema modifica la conexión a la base de datos. Si aún puedes acceder al panel de administración de WordPress (aunque sea de forma limitada), prueba esto:

Ve a Plugins > Plugins instalados.
Selecciona todos los plugins y en el menú desplegable elige Desactivar.
Si el error desaparece, reactiva los plugins de uno en uno para encontrar el culpable.

Si no puedes acceder al panel, renombra la carpeta de plugins desde el administrador de archivos:

En la carpeta de WordPress, busca la carpeta wp-content.
Dentro, busca la carpeta plugins. Cámbiale el nombre a plugins_old.
Esto desactivará todos los plugins. Si el error se soluciona, sabes que uno de ellos era el problema. Luego, renombra la carpeta de nuevo a plugins y ve activándolos de a uno.

Solución 6: Verificar la configuración del servidor (para usuarios avanzados)

Si nada de lo anterior funciona, el problema podría ser más técnico:

Firewall o reglas de seguridad: Algunos firewalls bloquean las conexiones a la base de datos. Revisa las reglas de tu servidor o contacta a tu hosting.
Límite de conexiones: Si tu sitio tiene mucho tráfico, el servidor puede haber alcanzado el límite de conexiones simultáneas. Esto suele resolverse contactando al hosting para aumentar el límite.
Problema con el puerto: Asegúrate de que el puerto de MySQL (por defecto 3306) esté abierto y accesible. En algunos hosts, puede ser diferente.

[TIP] Si usas Syspanel, recuerda que el acceso es por el puerto 2106. Si tienes dudas sobre la configuración de red, consulta la documentación de tu proveedor.

Preguntas Frecuentes (FAQ)

1. ¿Por qué aparece este error después de mover mi sitio a otro hosting?

Es muy común. Al migrar, las credenciales de la base de datos cambian. Simplemente actualiza el archivo wp-config.php con los nuevos datos (nombre, usuario, contraseña, host). Si no sabes cómo, pide a tu nuevo hosting que te lo proporcione.

2. ¿El error puede deberse a un ataque de hackers?

Sí, es posible. Un atacante podría modificar tu archivo wp-config.php o borrar la base de datos. Si sospechas de un ataque, cambia todas tus contraseñas (WordPress, FTP, cPanel/Syspanel) y revisa si hay archivos extraños en tu instalación.

3. ¿Qué hago si no tengo acceso a cPanel ni a Syspanel?

Si no tienes acceso al panel de control, contacta a tu proveedor de hosting por teléfono o ticket. Ellos pueden verificar el estado de la base de datos y, si es necesario, restaurar una copia de seguridad. También puedes pedirles que te proporcionen las credenciales correctas para que tú mismo puedas editar el wp-config.php mediante FTP.

4. ¿El error puede desaparecer solo?

En raras ocasiones, si el servidor de base de datos se sobrecarga temporalmente, el error puede desaparecer al cabo de unos minutos. Pero si persiste más de 10-15 minutos, es mejor que actúes.

5. ¿Cómo evito este error en el futuro?

Haz copias de seguridad periódicas de tu base de datos (puedes usar plugins como UpdraftPlus o herramientas del hosting).
Actualiza WordPress, plugins y temas regularmente.
No instales plugins de fuentes dudosas.
Monitorea el estado de tu servidor (algunos hosts ofrecen alertas por correo).

Resumen rápido de pasos

Si estás en medio de una crisis, sigue este orden:

Revisa wp-config.php (credenciales).
Prueba el modo de reparación (agrega la línea, ejecuta, luego bórrala).
Verifica el estado del servidor (cPanel/Syspanel o contacto con hosting).
Restaura desde copia de seguridad (si tienes una).
Desactiva plugins/temas (si puedes acceder).
Contacta a tu hosting (si nada funciona).

Espero que esta guía te haya sido de ayuda. Recuerda que soy tu técnico de soporte amigable, y aunque este artículo es extenso, la mayoría de las veces el error se soluciona en el primer paso. ¡Mucho éxito con tu sitio WordPress!