Error establishing a database connection en WordPress: Solución (cPanel)

¿Tu WordPress ha dejado de funcionar de repente y te muestra el temido mensaje "Error establishing a database connection"? No te preocupes, no eres el primero al que le pasa y, sobre todo, tiene solución.

Este error es uno de los más comunes en el mundo de WordPress y, aunque parece muy técnico, en la mayoría de los casos se puede resolver siguiendo una serie de pasos lógicos y sencillos, incluso sin ser un experto.

En esta guía completa, pensada para usuarios sin experiencia técnica, vamos a desglosar qué significa este mensaje, por qué ocurre y, lo más importante, cómo solucionarlo paso a paso desde tu panel de control cPanel.

Empecemos con calma. No toques nada todavía. Solo respira y sigue esta ruta de diagnóstico.

¿Qué significa exactamente "Error establishing a database connection"?

Para entender el problema, imagina que tu web es una tienda física.

WordPress es el edificio y los muebles de la tienda.
Los archivos de tu tema y plugins son los productos que se muestran.
La base de datos es el almacén trasero donde se guardan todos los registros: los precios, los nombres de los productos, tus publicaciones, los comentarios de los clientes, etc.

Cuando alguien visita tu web, WordPress necesita ir al almacén (la base de datos) para buscar la información y mostrarla en el escaparate. El error error conexión base de datos WordPress significa que tu tienda (WordPress) no puede abrir la puerta del almacén. O la llave no funciona (credenciales incorrectas), o el almacén está cerrado por reformas (servidor de BD caído), o alguien ha cambiado la cerradura (datos corruptos).

En términos técnicos, WordPress intenta conectarse a un servidor MySQL o MariaDB usando unas credenciales específicas. Si falla la conexión, muestra ese mensaje genérico.

Síntomas comunes de este error

Antes de lanzarnos a arreglar nada, identifica cuál de estas situaciones estás viendo:

Error total: Toda la web muestra el mensaje de error. No puedes acceder ni al panel de administración (wp-admin).
Error intermitente: A veces la web carga y a veces no. Esto suele indicar un problema de sobrecarga en el servidor o una mala configuración de los límites de memoria.
Mensaje de "Base de datos no encontrada": Es una variante que indica que el nombre de la base de datos que WordPress busca no existe en el servidor.

El objetivo de esta guía es solucionar el error database connection de forma definitiva, así que vamos a ir de lo más simple a lo más complejo.

Paso 1: La regla de oro - Reiniciar el servidor (o esperar)

Parece una tontería, pero en el mundo del hosting, muchos de estos errores son temporales.

Si el error es intermitente: Puede que tu servidor esté saturado. Los servidores de hosting compartido a veces se saturan si un vecino (otra web en el mismo servidor) está consumiendo muchos recursos.
Solución: Espera de 5 a 15 minutos y recarga la página. Si el problema era un pico de tráfico o un proceso bloqueado, se solucionará solo.

[TIP] Si tienes acceso a cPanel, busca la opción "Restart MySQL" o "Restart Database" en la sección de "Métricas" o "Estado del Servidor". No siempre está disponible en planes compartidos, pero si lo ves, úsalo. Es como apagar y encender el router, pero para tu base de datos.

Paso 2: Comprobar las credenciales de la base de datos (El error más común)

Esta es la causa número uno. Cuando instalaste WordPress, creaste una base de datos, un usuario, una contraseña y un host. Si alguno de esos datos cambió (o se escribió mal originalmente), WordPress no puede entrar al "almacén".

Para verificarlo, necesitas revisar el archivo de configuración principal de WordPress: wp-config.php.

¿Cómo editar el archivo wp-config.php?

Accede a tu cPanel (generalmente en tudominio.com/cpanel).
Busca la sección "Archivos" y haz clic en "Administrador de archivos".
Ve a la carpeta public_html (o htdocs si usas otro gestor). Ahí estará tu instalación de WordPress.
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" o "Code Editor".
Busca las líneas que se parecen a estas:

// ** Configuraciones de MySQL - Puedes obtener esta información de tu proveedor de hosting ** //
/** El nombre de la base de datos de WordPress */
define( 'DB_NAME', 'tu_basededatos' );

/** Tu nombre de usuario de MySQL */
define( 'DB_USER', 'tu_usuario' );

/** Tu contraseña de MySQL */
define( 'DB_PASSWORD', 'tu_contraseña' );

/** Host de MySQL */
define( 'DB_HOST', 'localhost' );

¿Qué debo mirar?

Nombre de la BD (DB_NAME): ¿Existe? Puedes comprobarlo en cPanel > "Bases de datos MySQL".
Usuario (DB_USER): ¿Existe? Debe estar vinculado a la base de datos. En cPanel, verás una lista de bases y usuarios asignados.
Contraseña (DB_PASSWORD): Este es el punto débil. A veces, al cambiar la contraseña en cPanel por seguridad, olvidamos actualizarla en el archivo wp-config.php.

[WARNING] Si no estás seguro de la contraseña, la forma más segura de arreglarlo es cambiarla directamente desde cPanel:

Ve a "Bases de datos MySQL" en cPanel.
Localiza el usuario que usa WordPress (el que aparece en DB_USER).
Haz clic en "Cambiar contraseña" (o "Change Password").
Introduce una contraseña nueva y segura.
IMPORTANTE: Ahora debes copiar esa contraseña nueva y pegarla en el archivo wp-config.php que estás editando, en la línea DB_PASSWORD.
Guarda los cambios del archivo.

[TIP] A veces el problema es el DB_HOST. No siempre es localhost. Algunos hosts usan direcciones como mysql.tudominio.com o localhost:3306. Consulta la documentación de tu proveedor o, si usas Syspanel (el panel de control que antes llamábamos HestiaCP, accesible por el puerto 2106), revisa la configuración del sitio web para ver el host correcto. En cPanel, puedes ver el host en la sección de bases de datos, pero lo más habitual es que sea localhost.

Paso 3: Reparar la base de datos (Si las credenciales son correctas)

Si los datos son correctos pero el error persiste, puede que la base de datos esté dañada o corrupta. WordPress tiene una herramienta de reparación integrada, pero hay que activarla manualmente.

Activar el modo de reparación

Vuelve a editar el archivo wp-config.php.
Busca la línea que dice define( 'WP_DEBUG', false ); o similar.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */, añade esta línea nueva:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, visita esta dirección: tudominio.com/wp-admin/maint/repair.php
Verás una página que te ofrece dos opciones:
- Reparar base de datos: Solo repara los problemas.
- Reparar y optimizar base de datos: Repara y además limpia tablas sueltas (recomendado si el error es grave).
Haz clic en "Reparar y optimizar base de datos".
Espera a que termine. Verás mensajes de éxito o de error detallado.

[WARNING] Una vez terminado, ELIMINA LA LÍNEA que añadiste (define('WP_ALLOW_REPAIR', true);). Dejar esa línea activa es un riesgo de seguridad grave, ya que cualquiera podría acceder a esa herramienta.

Paso 4: Verificar el estado del servidor MySQL en cPanel

A veces el problema no es tu web, sino el motor de la base de datos en sí. Es como si el almacén estuviera cerrado por huelga.

En tu cPanel, busca la sección "Estado del servidor" o "Server Status" (a veces está en "Métricas" o "Información").
Busca el proceso MySQL o MariaDB.
Si aparece en rojo o con un estado de error, significa que el servicio se ha caído.

¿Qué hago si MySQL está caído?

Si tienes acceso root (VPS o dedicado): Puedes reiniciarlo desde la terminal con sudo systemctl restart mysql o sudo service mysql restart.
Si estás en hosting compartido (cPanel): No puedes reiniciarlo tú. Debes contactar con el soporte de tu proveedor de hosting inmediatamente y decirles: "Mi web muestra el error de conexión a la base de datos y en el estado del servidor veo MySQL caído. ¿Podéis reiniciarlo?".

[INFO] En el caso de usar Syspanel (HestiaCP), el puerto de acceso al panel es el 2106. Dentro de Syspanel, puedes reiniciar el servicio MySQL desde la sección de "Servicios" o "Servicios del sistema", pero al igual que en cPanel, si no tienes permisos de administrador del sistema, deberás pedir ayuda a tu proveedor.

Paso 5: Aumentar el límite de memoria de PHP (Si el error es intermitente)

Un error de conexión a veces es un síntoma de que PHP se queda sin memoria antes de poder conectarse a la BD. Esto es más común si usas muchos plugins o un tema pesado.

Para solucionarlo, vamos a editar el archivo wp-config.php de nuevo (la tercera vez, ya eres experto).

Añade esta línea justo después de las constantes de la base de datos (después de DB_HOST):

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

Guarda el archivo y recarga tu web.

Si esto no funciona, también puedes intentar editar el archivo .htaccess (en la raíz de public_html). Añade al principio:

php_value memory_limit 256M

[WARNING] Aumentar la memoria no es una solución mágica. Si el problema persiste, es que hay un plugin o script que está consumiendo demasiado. Desactiva los plugins uno a uno (renombrando la carpeta wp-content/plugins a plugins_old y luego volviendo a renombrar de uno en uno) para encontrar al culpable.

Paso 6: Comprobar el prefijo de las tablas de la base de datos

Este es un error menos común pero muy frustrante. En tu wp-config.php, hay una línea que dice:

$table_prefix = 'wp_';

Si por alguna razón el prefijo de tus tablas en la base de datos no coincide con el que está en el archivo de configuración, WordPress no encontrará las tablas.

¿Cómo comprobarlo?

Ve a cPanel > "Bases de datos MySQL".
Busca tu base de datos y haz clic en "phpMyAdmin".
En el panel izquierdo, verás las tablas de tu base de datos.
Mira el prefijo. Si todas empiezan por wp_, todo bien. Si empiezan por wp_abc_ o cualquier otra cosa, deberás cambiar la línea $table_prefix en wp-config.php para que coincida.

[TIP] Este paso es vital si has migrado tu web de un hosting a otro y el nuevo hosting tenía una instalación previa de WordPress.

Paso 7: Contactar con el soporte (Cuando todo lo demás falla)

Si has llegado hasta aquí y sigues viendo el error conexión base de datos WordPress, es hora de llamar a los profesionales.

Antes de contactar con tu proveedor de hosting, ten a mano esta información:

URL de tu sitio web.
Mensaje de error exacto (¿Es el genérico o uno específico de "Base de datos no encontrada"?).
Pasos que ya has realizado (diles que has comprobado las credenciales, que has intentado reparar la BD y que has reiniciado MySQL).
La fecha y hora en la que empezó el problema.

Con esta información, el soporte técnico podrá diagnosticar si es un problema a nivel de servidor (hardware, red, permisos) mucho más rápido.

Resumen rápido: Checklist de solución

Para que te quede claro, este es el orden de actuación que debes seguir:

Espera y recarga (por si es temporal).
Revisa wp-config.php y compara las credenciales con cPanel.
Cambia la contraseña de la BD en cPanel y actualízala en el archivo.
Activa la reparación desde wp-admin/maint/repair.php.
Comprueba el estado del servicio MySQL en el servidor.
Aumenta la memoria de PHP a 256M.
Verifica el prefijo de la tabla en phpMyAdmin.
Llama al soporte de tu hosting.

[INFO] Recuerda que si tu hosting usa Syspanel en lugar de cPanel (accesible por el puerto 2106), la estructura de carpetas y las secciones de bases de datos son similares, pero la interfaz cambia. Busca "Databases" o "Base de datos" en el menú lateral. La lógica de solución es exactamente la misma.

Esperamos que esta guía te haya sido de gran ayuda. La próxima vez que veas este error, ya sabrás que es un problema de comunicación entre WordPress y su "almacén", y que con paciencia y estos pasos, podrás solucionar el error database connection sin perder los nervios.