Solucionar 'Error establishing a database connection' en WordPress (cPanel)

¡Hola! Si estás leyendo esto, probablemente te has encontrado con el temido mensaje "Error establishing a database connection" en tu sitio WordPress alojado en cPanel. No te preocupes, es uno de los errores más comunes y, en la mayoría de los casos, tiene solución en pocos minutos. Aquí te voy a guiar paso a paso, como si estuviéramos en una llamada de soporte, para que puedas solucionar error WordPress cPanel sin necesidad de ser un experto en servidores.

Vamos a desglosar este problema. Este mensaje significa que WordPress no puede comunicarse con tu base de datos, donde se guardan tus artículos, páginas, comentarios y configuraciones. Es como si intentaras abrir la puerta de tu casa con una llave equivocada o si la cerradura estuviera rota. Vamos a revisar todas las "cerraduras" posibles.

¿Por qué ocurre este error? (Causas comunes)

Antes de lanzarnos a arreglar nada, es útil entender qué puede estar fallando. Las causas suelen ser muy concretas y casi siempre se reducen a estas cuatro:

Datos de acceso incorrectos: Las credenciales de la base de datos (nombre, usuario, contraseña y host) que están en tu archivo de configuración wp-config.php no coinciden con las reales de tu servidor cPanel.
Base de datos corrupta o dañada: Las tablas internas de tu base de datos pueden haberse dañado por un corte de energía, una migración fallida o un plugin conflictivo.
Servidor de base de datos caído o sobrecargado: El servidor MySQL/MariaDB que gestiona tu base de datos puede estar temporalmente fuera de servicio, en mantenimiento o colapsado por un exceso de recursos.
Límite de memoria excedido o recursos agotados: En ocasiones, tu cuenta de hosting alcanza su límite de conexiones simultáneas o de memoria, impidiendo nuevas conexiones a la base de datos.

Ahora que tenemos el mapa, vamos a explorar el territorio. Empezaremos por las soluciones más sencillas y avanzaremos hacia las más técnicas.

Primeros pasos: Diagnóstico rápido desde cPanel

Lo primero que debes hacer es mantener la calma. No borres nada todavía. Vamos a entrar en tu panel de control de cPanel para verificar el estado de las cosas.

1. Accede a tu panel de cPanel

Abre tu navegador y ve a la URL de acceso a cPanel (normalmente algo como tudominio.com/cpanel o tudominio.com:2083). Introduce tu nombre de usuario y contraseña.

2. Verifica el estado de la base de datos

Dentro de cPanel, busca la sección "Bases de datos MySQL" o "MySQL Databases". Haz clic para entrar. Aquí verás una lista de todas las bases de datos asociadas a tu cuenta. Al lado de cada una, suele haber un icono o un enlace que dice "Repair Database" o "Reparar base de datos".

[TIP] Si ves un signo de exclamación o un mensaje de error junto a tu base de datos, eso es una señal de que está dañada. Ejecuta la reparación desde aquí. Es un proceso seguro que intenta arreglar las tablas automáticamente.

3. Comprueba el espacio en disco

A veces, si tu cuenta de hosting se queda sin espacio en disco, la base de datos no puede funcionar correctamente. Ve a la pestaña de "Estadísticas" o "Información del servidor" en cPanel para ver cuánto espacio estás utilizando. Si está al 90% o más, es hora de limpiar archivos temporales, copias de seguridad antiguas o cachés.

La solución clásica: Revisar y actualizar `wp-config.php`

Este es el archivo de configuración más importante de WordPress. Contiene las "llaves" para abrir la puerta de la base de datos. Si el error persiste, es el primer lugar donde debemos mirar.

1. Localiza el archivo

Accede a tu gestor de archivos de cPanel (File Manager). Normalmente está en la sección "Archivos". Una vez dentro, busca la carpeta public_html (o el nombre de tu carpeta raíz si has instalado WordPress en una subcarpeta). Dentro, busca el archivo llamado wp-config.php.

[WARNING] No hagas clic derecho y "Editar" aún. Primero, haz una copia de seguridad: haz clic derecho sobre el archivo y selecciona "Copiar" o "Download". Es crucial tener una copia por si algo sale mal.

2. Edita el archivo

Ahora sí, haz clic derecho sobre wp-config.php y selecciona "Edit" (Editar). Se abrirá un editor de texto. 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_usuario_wpdb' );

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

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

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

3. Compara con la información de cPanel

Ahora, ve a la sección "Bases de datos MySQL" en cPanel. Verás que el nombre de tu base de datos y el usuario tienen un prefijo que es tu nombre de usuario de cPanel (ej. juanperez_wpdb). Asegúrate de que:

DB_NAME coincide exactamente con el nombre de la base de datos en cPanel.
DB_USER coincide exactamente con el nombre de usuario de la base de datos en cPanel.
DB_PASSWORD es la contraseña que asignaste a ese usuario de base de datos. Si no la recuerdas, puedes cambiarla desde cPanel (opción "Change Password" en la misma sección de bases de datos).
DB_HOST generalmente es localhost, pero a veces puede ser 127.0.0.1 o un nombre de servidor específico como mysql.tudominio.com. Puedes encontrar esta información en la sección de "Bases de datos MySQL" o en los correos de bienvenida de tu hosting.

4. Guarda y comprueba

Una vez que hayas corregido los datos, haz clic en "Save Changes" (Guardar cambios). Ahora, intenta cargar tu sitio web. Si el problema era este, ya debería funcionar.

[INFO] Si cambiaste la contraseña del usuario de la base de datos, asegúrate de actualizarla también en wp-config.php. Es un error muy común olvidar este paso.

Si el problema continúa: Reparando la base de datos

Si los datos de acceso son correctos y el error persiste, es muy probable que la base de datos esté dañada. WordPress tiene una herramienta integrada para repararla, pero hay que activarla manualmente.

1. Activa el modo de reparación

Ve a tu gestor de archivos y de nuevo a public_html. Busca el archivo wp-config.php y edítalo. Añade la siguiente línea justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:

define('WP_ALLOW_REPAIR', true);

2. Ejecuta la reparación

Guarda el archivo. Ahora, en tu navegador, ve a la siguiente URL (reemplaza tudominio.com por tu dominio real):

https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla con dos opciones: "Repair Database" (Reparar) y "Repair and Optimize Database" (Reparar y optimizar). Haz clic en la primera. WordPress intentará arreglar todas las tablas dañadas.

3. Desactiva el modo de reparación

IMPORTANTE: Una vez que la reparación haya terminado, debes eliminar la línea que añadiste (define('WP_ALLOW_REPAIR', true);) del archivo wp-config.php inmediatamente. Dejar este modo activo es un riesgo de seguridad, ya que cualquiera podría acceder a esa URL.

4. Comprueba tu sitio

Vuelve a cargar tu web. Si la base de datos estaba dañada, esto debería haberlo solucionado.

Solución avanzada: Acceso por SSH o MySQL desde cPanel

Si nada de lo anterior funciona, necesitamos ser un poco más técnicos. Vamos a acceder directamente a la base de datos para diagnosticar el problema.

1. Usa phpMyAdmin

En cPanel, busca el icono "phpMyAdmin" dentro de la sección de "Bases de datos". Haz clic para abrirlo. A la izquierda, verás la lista de tus bases de datos. Haz clic en el nombre de la base de datos de tu WordPress.

2. Revisa las tablas

Una vez dentro, verás una lista de tablas (normalmente empiezan con wp_). En la parte inferior de la página, en la sección "Check all" (Seleccionar todo), hay un menú desplegable. Selecciona "Check Table" (Verificar tabla) y haz clic en "Go". Esto comprobará la integridad de todas las tablas. Si alguna está dañada, te lo indicará.

3. Repara desde phpMyAdmin

Si encuentras tablas dañadas, selecciónalas de nuevo y en el menú desplegable elige "Repair Table" (Reparar tabla). Haz clic en "Go" y espera a que termine. Este es un proceso seguro que intenta reconstruir los índices y datos dañados.

[TIP] Si no puedes reparar desde phpMyAdmin, es posible que necesites hacerlo desde la línea de comandos SSH. Si no sabes qué es SSH, ignora este paso y pasa a la siguiente solución.

El problema es el servidor: ¿Qué hago?

A veces, el error no está en tu WordPress, sino en el servidor que lo aloja. El servidor de base de datos (MySQL) puede estar caído o sobrecargado.

1. Verifica el estado general del servidor

En cPanel, a veces hay un widget o una sección llamada "Server Status" (Estado del servidor) o "Server Information" (Información del servidor). Busca si el servicio MySQL aparece como "Running" (En ejecución) o si está "Stopped" (Detenido).

2. Reinicia el servicio (si tu plan lo permite)

Algunos planes de hosting (como VPS o dedicados) te permiten reiniciar los servicios desde cPanel. Busca una sección llamada "Restart Services" o similar. Si ves la opción de reiniciar MySQL, hazlo con cuidado.

[WARNING] Reiniciar un servicio puede afectar a otros sitios en tu servidor. Si estás en un hosting compartido, es muy probable que no tengas esta opción. En ese caso, contacta con tu proveedor.

3. Contacta con tu proveedor de hosting

Si todo lo demás ha fallado, es hora de llamar a los profesionales. Tu proveedor de hosting tiene herramientas y acceso a nivel de servidor que tú no tienes. Explícales que has seguido todos los pasos de este tutorial y que el error persiste. Diles que has verificado tus credenciales, reparado la base de datos y que el servicio MySQL parece inaccesible. Ellos podrán verificar los logs del servidor y reiniciar el servicio si es necesario.

Soluciones alternativas y trucos finales

A veces, el problema es más escurridizo. Aquí tienes algunas cosas más que puedes probar.

1. Revisa los plugins y temas

Aunque no puedas entrar en el panel de administración, puedes desactivar todos los plugins manualmente.

Ve a tu gestor de archivos en cPanel.
Entra en public_html/wp-content/.
Busca la carpeta plugins. Haz clic derecho sobre ella y selecciona "Rename" (Renombrar). Cámbiale el nombre a plugins_old.

Si el problema era un plugin, tu sitio debería volver a funcionar. Si es así, ve renombrando las carpetas de los plugins de uno en uno dentro de plugins_old, creando una nueva carpeta plugins y moviendo cada plugin de vuelta para encontrar al culpable.

2. Aumenta el límite de memoria de PHP

A veces, un límite de memoria bajo puede causar fallos en la conexión. Edita tu archivo wp-config.php y añade esta línea:

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

Guarda el archivo y comprueba si el error desaparece.

3. Verifica el puerto de la base de datos

En casos muy raros, el host de tu base de datos no es localhost y requiere un puerto específico. Si tu proveedor de hosting te ha dado un puerto, puedes añadirlo al DB_HOST. Por ejemplo:

define( 'DB_HOST', 'localhost:3307' );

Pero esto solo debes hacerlo si tu proveedor te lo indica explícitamente.

4. Reinstala los archivos de WordPress

Si sospechas que el archivo wp-config.php está corrupto (no solo con datos incorrectos, sino físicamente dañado), puedes reemplazarlo. Descarga una copia nueva de WordPress desde wordpress.org, extrae el archivo wp-config-sample.php, renómbralo a wp-config.php, edítalo con tus datos de conexión y súbelo a tu servidor.

[INFO] Si tu hosting es Syspanel (el panel que antes se llamaba HestiaCP), el acceso a archivos y bases de datos es similar, pero lo harás desde el puerto 2106 (ej. tudominio.com:2106). Busca las secciones de "Archivos" y "Bases de datos" dentro de ese panel.

Preguntas Frecuentes (FAQ)

¿Por qué recibo este error después de una migración?

Es muy común. Al migrar, las credenciales de la base de datos suelen cambiar. Asegúrate de que el wp-config.php del nuevo servidor tenga los datos correctos del nuevo hosting.

¿Puedo perder mis datos si reparo la base de datos?

La reparación de tablas es un proceso seguro que intenta reconstruir los índices y datos dañados sin borrar información. Sin embargo, siempre es recomendable tener una copia de seguridad reciente antes de hacer cualquier reparación.

¿Este error tiene relación con el SEO de mi web?

Sí, indirectamente. Si el error persiste durante mucho tiempo, los motores de búsqueda como Google intentarán acceder a tu web y recibirán un error del servidor. Si esto se prolonga, puede afectar negativamente a tu posicionamiento. Por eso es tan importante solucionarlo rápido.

¿Qué pasa si el error aparece solo a veces?

Si el error es intermitente, es casi seguro que es un problema de recursos del servidor. Tu sitio está alcanzando el límite de conexiones a la base de datos. Contacta con tu proveedor de hosting para aumentar los recursos o considera cambiar a un plan mejor.

¿Un plugin de caché puede causar este error?

En casos muy raros, un plugin de caché mal configurado puede causar conflictos. Desactivarlo (renombrando la carpeta) es una de las primeras pruebas que debes hacer.

Conclusión

El error establishing database connection cPanel puede ser frustrante, pero como has visto, tiene soluciones muy claras y lógicas. Hemos cubierto desde lo más básico (verificar credenciales) hasta lo más avanzado (reparar tablas desde phpMyAdmin). La clave es ir paso a paso, sin prisas y sin borrar nada sin hacer una copia de seguridad.

Recuerda el orden de actuación:

Verifica las credenciales en wp-config.php.
Comprueba el espacio en disco.
Repara la base de datos desde cPanel o phpMyAdmin.
Desactiva plugins manualmente.
Contacta con tu proveedor si nada funciona.

Con un poco de paciencia, tu sitio web volverá a estar en línea en un abrir y cerrar de ojos. Espero que esta guía te haya sido de gran ayuda. Si te surge cualquier otra duda, no dudes en buscar más información o contactar con el soporte técnico de tu hosting. ¡Buena suerte!