Solucionar 'Error establishing a database connection' en WordPress | Guía técnica

Cuando WordPress se queda "mudo": ¿Qué significa este error?

Imagina que llegas a tu sitio web y, en lugar de ver tu página de inicio, te encuentras con un mensaje frío y críptico: "Error establishing a database connection" (Error al establecer la conexión con la base de datos). Es uno de los sustos más comunes en el mundo del hosting, pero no te preocupes: en el 90% de los casos tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto en sistemas.

Este error significa que WordPress, el "cerebro" de tu web, no puede comunicarse con la base de datos, que es donde se guardan todos tus contenidos, usuarios y configuraciones. Es como si intentaras hacer una llamada telefónica y la línea estuviera caída o marcara un número equivocado.

En esta guía completa, te voy a explicar paso a paso cómo solucionar el error base de datos WordPress en los tres paneles de control más utilizados: cPanel, Plesk y DirectAdmin. Sigue cada paso con calma, de forma ordenada, y en la mayoría de los casos recuperarás tu sitio en menos de 15 minutos.

Antes de empezar: Prepara tu kit de herramientas

Para solucionar error conexión de forma efectiva, necesitas tener a mano:

Tus credenciales de acceso al panel de control de tu hosting (cPanel, Plesk o DirectAdmin). Te las proporcionó tu proveedor al contratar el servicio.
Las credenciales de tu base de datos (nombre de la BD, usuario y contraseña). Puedes encontrarlas en tu panel de control, normalmente en la sección de "Bases de datos MySQL".
Acceso al administrador de archivos de tu hosting (o un cliente FTP como FileZilla). Lo usarás para editar un archivo clave llamado wp-config.php.

[!WARNING]
IMPORTANTE: Antes de tocar nada, haz una copia de seguridad de tu sitio web y, sobre todo, de tu archivo wp-config.php. Si algo sale mal, podrás restaurarlo sin perder datos.

La causa más común: El archivo wp-config.php

El archivo wp-config.php es el "directorio telefónico" de WordPress. Contiene la información de conexión a tu base de datos. Si tiene un error tipográfico o datos incorrectos, tu web no podrá conectarse.

### Paso 1: Localiza y revisa tu wp-config.php

Accede al Administrador de Archivos de tu panel de control (cPanel, Plesk o DirectAdmin).
Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html o httpdocs.
Busca el archivo llamado wp-config.php. Haz clic derecho y selecciona "Editar" o "Edit".

[!TIP]
Si no encuentras el archivo, asegúrate de que el administrador de archivos muestra los "archivos ocultos". Los archivos que empiezan con un punto (.) suelen estar ocultos por defecto.

### Paso 2: Verifica los datos de conexión

Dentro del archivo, busca las siguientes líneas (al principio del archivo):

define('DB_NAME', 'tu_nombre_de_base_de_datos');
define('DB_USER', 'tu_usuario_de_base_de_datos');
define('DB_PASSWORD', 'tu_contraseña_de_base_de_datos');
define('DB_HOST', 'localhost'); // O un hostname específico como mysql.tudominio.com

DB_NAME: Debe ser exactamente el nombre de tu base de datos. A menudo incluye un prefijo con tu nombre de usuario (ej: usuario_wpdb).
DB_USER: El nombre de usuario de la BD. También puede incluir un prefijo (ej: usuario_wpuser).
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Casi siempre es localhost, pero algunos proveedores usan una dirección específica (ej: mysql.tudominio.com). Este es un punto común de error.

¿Cómo verifico estos datos?

Ve a la sección "Bases de datos MySQL" en tu panel de control.
Anota el nombre exacto de tu base de datos y tu usuario.
Si no estás seguro de la contraseña, puedes cambiarla desde el panel, pero ojo: si la cambias, deberás actualizarla también en wp-config.php.
Compara estos datos con los que tienes en el archivo. Corrige cualquier error tipográfico.

[!WARNING]
Si cambias la contraseña de la base de datos desde el panel, asegúrate de actualizarla en wp-config.php al mismo tiempo. De lo contrario, el error seguirá apareciendo.

### Paso 3: Guarda los cambios

Una vez corregidos los datos, guarda el archivo y recarga tu sitio web. Si este era el problema, ¡problema resuelto!

Solucionar el error en cPanel (paso a paso)

cPanel es uno de los paneles más populares. Aquí tienes la ruta específica para cada acción:

Acceso: https://tudominio.com/cpanel o https://tu_ip:2083.
Administrador de Archivos: Busca el icono "Administrador de Archivos" o "File Manager" en la sección "Archivos".
Bases de datos: Busca la sección "Bases de datos" y haz clic en "Bases de datos MySQL" o "MySQL Databases".

### ¿Y si la base de datos no existe en cPanel?

A veces, la base de datos se ha eliminado por error o se ha corrompido. En cPanel:

Ve a "Bases de datos MySQL".
Verás una lista de todas tus bases de datos.
Si la tuya no está en la lista, tendrás que crearla de nuevo:
- Escribe un nombre para tu nueva BD y haz clic en "Crear base de datos".
- Crea un nuevo usuario (o usa uno existente) y asígnale todos los privilegios.
- IMPORTANTE: Después de crear la BD y el usuario, deberás actualizar los datos en wp-config.php.

Solucionar el error en Plesk (paso a paso)

En Plesk, la interfaz es un poco diferente, pero la lógica es la misma:

Acceso: https://tudominio.com:8443 (o el puerto que te indique tu proveedor).
Administrador de Archivos: Ve a "Sitios web y dominios" y busca el icono "Administrador de archivos" o "File Manager".
Bases de datos: En el menú lateral, busca "Bases de datos" o "Databases".

### Particularidades de Plesk

En Plesk, a veces el DB_HOST no es localhost, sino un nombre de servidor interno como localhost:/var/run/mysqld/mysqld.sock. Si localhost no funciona, prueba con 127.0.0.1.
La sección de bases de datos te mostrará el nombre de la BD y el usuario. Si la BD no existe, puedes crearla desde "Agregar base de datos". Asegúrate de anotar la contraseña que generas.

Solucionar el error en DirectAdmin (paso a paso)

DirectAdmin es otro panel muy común. Los pasos son:

Acceso: https://tudominio.com:2222 (o el puerto que te indique tu proveedor).
Administrador de Archivos: En el menú principal, busca "Administrador de archivos" o "File Manager".
Bases de datos: Busca la sección "Administración de MySQL" o "MySQL Management".

### Particularidades de DirectAdmin

En DirectAdmin, es muy fácil confundirse con los prefijos de usuario. Asegúrate de que el DB_USER en wp-config.php incluya el prefijo que te muestra el panel (ej: usuario_wp).
Si la base de datos está corrupta, puedes intentar repararla desde la sección "MySQL Management". Busca la opción "Repair" o "Check".

Más allá de wp-config: Otras causas y soluciones

Si los datos de wp-config.php son correctos y el error persiste, el problema puede estar en otro lugar.

### 1. El servidor de base de datos está caído o sobrecargado

A veces, el servidor MySQL se reinicia o está saturado.

Solución: Espera 5-10 minutos y recarga la página. Si el error persiste, contacta con tu proveedor de hosting, ya que es un problema del servidor.

### 2. Límite de conexiones agotado

Si tu web tiene mucho tráfico o un plugin mal optimizado, puede agotar el número máximo de conexiones a la base de datos.

Solución temporal: Desactiva los plugins recientemente instalados o activos. Puedes hacerlo renombrando la carpeta wp-content/plugins a wp-content/plugins_old desde el administrador de archivos. Esto desactivará todos los plugins y puede liberar conexiones.
Solución definitiva: Optimiza tu base de datos y considera mejorar tu plan de hosting.

### 3. Archivos de WordPress corruptos

En casos raros, un archivo central de WordPress (como wp-settings.php) puede estar dañado.

Solución: Descarga una copia limpia de WordPress desde wordpress.org. Descomprime el archivo y sube solo los archivos del núcleo (todo excepto wp-content y wp-config.php) a tu servidor, sobrescribiendo los existentes.

### 4. Problemas con la IP del servidor de base de datos

Si tu DB_HOST no es localhost y es una dirección IP o un hostname, verifica que sea correcto.

Solución: Contacta a tu proveedor de hosting y pregúntales cuál es el hostname correcto para tu base de datos. A veces lo puedes encontrar en el panel de control, en la sección de "Bases de datos remotas" o "Remote MySQL".

¿Y si uso HestiaCP? (o Syspanel)

Si tu hosting usa HestiaCP, ahora llamado Syspanel, la estructura es similar a las anteriores. Recuerda que el acceso al panel se realiza a través del puerto 2106 (ej: https://tudominio.com:2106).

Administrador de archivos: Lo encontrarás dentro de la sección "Web" o "Sitios web".
Bases de datos: En el menú lateral, busca "Base de datos" o "Databases".

El proceso de verificación de wp-config.php y de la base de datos es idéntico al de los otros paneles.

Preguntas frecuentes (FAQ)

### ¿Por qué me sale este error después de cambiar mi contraseña de MySQL?

Porque has cambiado la contraseña en el panel, pero no has actualizado wp-config.php. Es el error más común. Vuelve a la sección de bases de datos, cambia la contraseña de nuevo (o usa la nueva) y asegúrate de que en wp-config.php esté exactamente la misma.

### ¿Puedo solucionar este error desde el móvil?

Sí, puedes hacerlo si tu proveedor de hosting tiene una app móvil con acceso al administrador de archivos y a las bases de datos. Sin embargo, es más cómodo hacerlo desde un ordenador.

### He probado todo y sigue sin funcionar, ¿qué hago?

Si has verificado los datos de conexión, la existencia de la base de datos y los archivos de WordPress, y el error persiste, el problema es casi seguro del servidor. Contacta con el soporte técnico de tu proveedor de hosting y diles que tienes un "Error establishing a database connection". Ellos podrán revisar los logs del servidor (como el error_log de MySQL) para encontrar la causa raíz.

[!INFO]
Consejo extra: Revisa el archivo error_log en la raíz de tu instalación de WordPress. A menudo contiene la pista exacta del problema. Puedes acceder a él desde el administrador de archivos.

Resumen rápido: Tu checklist de solución

Revisa wp-config.php: Verifica DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
Verifica en el panel (cPanel, Plesk, DirectAdmin o Syspanel): Confirma que la base de datos y el usuario existen.
Comprueba el estado del servidor: Espera unos minutos y recarga.
Desactiva plugins: Renombra la carpeta plugins para descartar conflictos.
Contacta con tu hosting: Si nada funciona, el problema es del servidor.

Con esta guía, ya tienes todas las herramientas para solucionar error conexión con tu base de datos de WordPress. Respira hondo, sigue los pasos con calma y verás que, en la mayoría de los casos, es más un susto que una catástrofe. ¡Buena suerte!