Solucionar 'Error establishing a database connection' en WordPress

Este es uno de los errores más temidos por cualquier persona que gestiona una web. Ver el mensaje "Error establishing a database connection" en tu WordPress puede parecer el fin del mundo, pero respira. En el 90% de los casos, la solución es más sencilla de lo que parece y no has perdido tu contenido.

Este error significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan tus artículos, páginas y configuraciones. Es como si intentaras abrir una caja fuerte (tu web) pero la llave (los datos de acceso) no encaja o la cerradura (el servidor de base de datos) está atascada.

En esta guía extensa y paso a paso, voy a explicarte cómo solucionar el error base de datos wordpress tanto si tu hosting usa cPanel como si usa Plesk. No necesitas ser un experto en programación, solo seguir el orden lógico de esta lista. Vamos a ello.

¿Por qué ocurre este error?

Antes de ponernos manos a la obra, es útil entender el origen. El error establishing database connection no suele aparecer por una sola causa, sino por varias. Las más comunes son:

Datos de acceso incorrectos: La contraseña o el usuario de la base de datos han cambiado o están mal escritos en tu archivo de configuración.
Servidor de base de datos caído: El servidor MySQL o MariaDB está sobrecargado o detenido.
Base de datos corrupta: Los archivos de la base de datos han sufrido daños.
Límites de recursos agotados: Tu cuenta de hosting ha superado el límite de conexiones simultáneas.
Cambios en el servidor: El proveedor de hosting ha migrado los servidores y la IP del host de la base de datos ha cambiado.

Vamos a atacar cada una de estas causas desde la más simple a la más compleja.

Paso 1: La prueba del "arpón" (Reiniciar el servidor)

A veces la solución es tan simple como un reinicio. Si tu proveedor de hosting tiene un panel de control (cPanel o Plesk), busca la opción de "Reiniciar" o "Restart" para el servicio de MySQL o MariaDB.

[TIP] En cPanel, a veces esta opción está en "Métricas" o en "Estado del Servidor". En Plesk, suele estar en "Herramientas y Ajustes" > "Servicios". Si no la encuentras, contacta con el soporte técnico y pídeles que reinicien el servicio de base de datos. Es un proceso de 5 segundos para ellos y a menudo arregla el problema al instante.

Paso 2: Verificar los datos de acceso (El archivo wp-config.php)

Esta es la causa más frecuente. WordPress guarda los datos de conexión en un archivo llamado wp-config.php. Si estos datos no coinciden exactamente con los del servidor, la conexión falla.

¿Cómo editar el archivo sin romper nada?

Accede a tu hosting: Entra en cPanel o Plesk.
Busca el Administrador de Archivos: En cPanel suele estar en la sección "Archivos". En Plesk, ve a "Sitios web y dominios" > "Acceso al servidor" o usa el "Administrador de archivos".
Navega hasta la raíz: Busca la carpeta public_html (o httpdocs en Plesk). Ahí dentro estará tu WordPress y el archivo wp-config.php.
Edita el archivo: Haz clic derecho sobre wp-config.php y selecciona "Editar" o "Edit". No uses el editor de texto de Windows; usa el editor del panel.

Dentro del archivo, busca líneas como estas:

define( 'DB_NAME', 'tu_usuario_wpdb' );
define( 'DB_USER', 'tu_usuario_bd' );
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );
define( 'DB_HOST', 'localhost' );

Ahora, la parte crítica: Compara estos valores con los que tienes en tu panel de control.

DB_NAME: Es el nombre de tu base de datos.
DB_USER: Es el usuario de la base de datos.
DB_PASSWORD: Es la contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero a veces es un servidor remoto como mysql.tudominio.com o localhost:3306.

¿Dónde encuentro los datos correctos?

En cPanel:

Ve a la sección "Bases de datos" > "Bases de datos MySQL".
Ahí verás el nombre de la base de datos (DB_NAME).
En "Usuarios MySQL" verás el usuario (DB_USER).
Si no recuerdas la contraseña, tendrás que cambiarla. Haz clic en "Cambiar contraseña" para ese usuario. Atención: Al cambiar la contraseña, debes actualizar también el wp-config.php con la nueva.

En Plesk:

Ve a "Sitios web y dominios".
Busca la sección "Bases de datos" o "Bases de datos MySQL".
Ahí verás el nombre de la BD y el usuario. Para cambiar la contraseña, selecciona la base de datos y busca la opción "Cambiar contraseña" en la barra superior.

[WARNING] Cuidado con los prefijos: En cPanel, el nombre de la base de datos y el usuario suelen llevar un prefijo con tu nombre de usuario de hosting. Por ejemplo, usuario123_wpdb. Debes copiarlo exactamente igual, incluyendo el guion bajo. Un simple error tipográfico provoca este fallo.

Solución: Si has cambiado la contraseña en el panel, actualiza el archivo wp-config.php con la nueva contraseña y guarda los cambios. Recarga tu web.

Paso 3: Reparar la base de datos (El modo de reparación)

WordPress tiene un modo oculto para reparar bases de datos dañadas. Es muy fácil de activar.

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

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, visita esta URL: tudominio.com/wp-admin/maint/repair.php

Verás una pantalla con dos botones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en el primero (o el segundo si te sientes valiente).

Espera a que termine el proceso.
IMPORTANTE: Una vez terminado, borra esa línea del wp-config.php y guarda el archivo. Dejar esa línea activa es un riesgo de seguridad porque cualquiera podría intentar reparar tu base de datos.

Paso 4: Comprobar el estado del servidor de base de datos

Si los datos son correctos y la reparación no funciona, el problema puede ser del servidor. Esto es más común en hosting compartido.

En cPanel: Ve a "Estado del servidor" o "Métricas". Busca "MySQL" y comprueba si está en verde o tiene algún icono de error.
En Plesk: Ve a "Herramientas y Ajustes" > "Servicios". Busca "MySQL" y mira su estado.

Si el servicio aparece "caído" o "detenido", no puedes hacer nada desde tu panel. Debes contactar con el soporte técnico de tu proveedor de hosting. Diles: "Estoy recibiendo un error establishing database connection y el servicio MySQL parece estar caído. ¿Podéis reiniciarlo o revisarlo?"

[INFO] A veces, el servidor MySQL no está caído, sino que está sobrecargado. Esto pasa cuando hay demasiadas conexiones simultáneas. En ese caso, el soporte técnico puede aumentar el límite de conexiones o optimizar el servidor.

Paso 5: Aumentar el límite de memoria de PHP (Solución avanzada)

A veces, el error base de datos wordpress no es por la base de datos en sí, sino por falta de memoria en PHP. Si tu web tiene muchos plugins, puede agotar la memoria asignada.

Para solucionarlo, añade esta línea a tu wp-config.php:

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

Guarda y recarga. Si no funciona, puedes intentar aumentar el límite de memoria del servidor añadiendo esta línea a tu archivo .htaccess (en la raíz de tu WordPress):

php_value memory_limit 256M

Paso 6: Revisar el archivo .htaccess (Causa rara pero posible)

Un .htaccess corrupto puede causar conflictos. No es la causa más común de este error, pero lo he visto pasar.

En el Administrador de Archivos, busca el archivo .htaccess en la carpeta raíz.
Renómbralo a .htaccess_backup.
Recarga tu web. Si funciona, el problema era ese archivo.
Ve a Ajustes > Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios" para regenerar un .htaccess limpio.

Paso 7: Contactar con el soporte del hosting (La solución definitiva)

Si has llegado hasta aquí y el error persiste, es hora de llamar a los profesionales. No te frustres, hay cosas que solo ellos pueden ver.

Información que debes tener preparada antes de llamar:

Tu nombre de usuario de hosting.
El dominio afectado.
Una captura de pantalla del error.
Los pasos que ya has intentado (por ejemplo, "He verificado el wp-config.php, he intentado reparar la BD y he comprobado el estado del servidor").

Un buen soporte técnico podrá revisar los logs del servidor (registros de errores) para ver el motivo exacto del fallo, algo que tú no puedes ver desde tu panel.

[WARNING] Sobre Syspanel: Si tu hosting usa Syspanel en lugar de cPanel o Plesk, el proceso es similar. El acceso a los archivos se realiza a través del Administrador de Archivos del panel, y la gestión de bases de datos está en la sección "Bases de datos". Recuerda que el puerto de acceso a Syspanel es el 2106 (ejemplo: tudominio.com:2106). Los pasos para editar wp-config.php son idénticos.

Preguntas Frecuentes (FAQ)

¿He perdido mis datos si veo este error?

No. Este error es de conexión, no de pérdida de datos. Tus artículos, páginas y comentarios siguen intactos en la base de datos. El problema es que WordPress no puede "leerlos" en ese momento. Una vez resuelto el problema de conexión, todo volverá a la normalidad.

¿Por qué me sale este error después de mover mi web a otro hosting?

Es muy común. Al migrar, los datos de acceso a la base de datos cambian. Debes actualizar el archivo wp-config.php con los nuevos datos que te proporciona el nuevo hosting. Es el Paso 2 de esta guía, pero con los datos del nuevo servidor.

¿Puede ser un ataque de hackers?

Es poco probable, pero posible. Un ataque puede corromper la base de datos o cambiar los datos de acceso. Si sospechas de un ataque, además de seguir los pasos anteriores, cambia todas tus contraseñas (panel de control, FTP y base de datos) y escanea tu web con un plugin de seguridad.

¿Cada cuánto debo revisar mi base de datos?

No hay una regla fija. Pero si tu web es grande o tiene mucho tráfico, es buena práctica optimizarla (no repararla, eso solo cuando hay errores) cada 1 o 2 meses usando plugins como WP-Optimize. Esto previene la corrupción de tablas.

Si uso Syspanel, ¿dónde está el botón de reiniciar MySQL?

En Syspanel (puerto 2106), busca la sección de "Servicios" o "Estado del servidor". La interfaz es limpia y suele tener un icono de "play" o "reiniciar" junto al servicio MySQL. Si no lo encuentras, contacta con el soporte del hosting que utiliza Syspanel.

Resumen rápido (La hoja de ruta)

Reinicia el servicio MySQL desde tu panel (o pide al soporte que lo haga).
Verifica el archivo wp-config.php con los datos exactos de tu base de datos. (Paso más común).
Activa el modo de reparación de WordPress.
Comprueba el estado del servidor en tu panel.
Aumenta el límite de memoria PHP.
Renombra el .htaccess para descartar problemas.
Contacta con el soporte de tu hosting con toda la información.

El error establishing database connection es un susto, pero casi siempre tiene solución en los primeros tres pasos. Tómate tu tiempo, sigue el orden y no edites archivos sin hacer una copia de seguridad previa (puedes descargar el wp-config.php a tu ordenador antes de tocarlo). Con paciencia y esta guía, tu web volverá a estar en línea en poco tiempo. ¡Mucha suerte!