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

¿Qué significa “Error establishing a database connection”?

Este es uno de los errores más comunes y, a la vez, más temidos en WordPress. Básicamente, significa que tu sitio web no puede conectarse con la base de datos donde se guardan tus publicaciones, páginas, comentarios y configuraciones. Sin esa conexión, WordPress no puede funcionar y muestra ese mensaje en blanco.

No te preocupes, en la gran mayoría de los casos tiene una solución sencilla. No necesitas ser un experto en programación para resolverlo. Solo debes seguir estos pasos con calma y en orden.

En este artículo, te guiaré paso a paso para solucionar el error de base de datos en WordPress desde cPanel, el panel de control que usan la mayoría de los hosting. Vamos a ello.

Antes de empezar: ¿Qué necesitas tener a mano?

Para este proceso, necesitarás:

Acceso a tu cPanel: La URL suele ser algo como tudominio.com/cPanel o cpanel.tudominio.com. Usa el usuario y contraseña que te dio tu proveedor de hosting.
Acceso a tu gestor de archivos: Está dentro de cPanel. Te permitirá ver y editar los archivos de tu web.
Paciencia y un café: No es complicado, pero hay que ir con cuidado.

Paso 1: La solución más rápida (y la que más veces funciona)

Antes de tocar nada técnico, prueba esto. En muchos casos, el error es temporal y se soluciona con un simple reinicio.

1.1. Reiniciar los servicios de tu hosting (si tu proveedor lo permite)

Algunos paneles de cPanel tienen una opción para reiniciar los servicios de MySQL o MariaDB (el motor de la base de datos). Si ves algo como “Restart MySQL” o “Reiniciar servicios”, pruébalo. Espera un minuto y recarga tu web.

[TIP] Si no encuentras esa opción, no la busques más. Ve al siguiente paso.

1.2. Revisar si es un problema general del servidor

A veces, el problema no es tu web, sino el servidor donde está alojada. Puedes usar herramientas externas como “Is It Down Right Now” para comprobar si tu web está caída para todo el mundo o solo para ti. Si el servidor está caído, no hay nada que hacer salvo esperar a que tu proveedor lo arregle.

Paso 2: Verificar la configuración de la base de datos en wp-config.php

Este es el archivo más importante para tu WordPress. Contiene las credenciales de acceso a tu base de datos. Si estos datos son incorrectos, obtendrás ese error.

2.1. Cómo acceder al archivo wp-config.php

Entra a tu cPanel.
Busca el ícono del Administrador de archivos (File Manager). Suele estar en la sección “Archivos”.
Entra a la carpeta public_html (o la carpeta donde está instalado tu WordPress, a veces puede ser una subcarpeta como public_html/miweb).
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona Editar (o Edit). Si te pide confirmación, acéptala.

2.2. ¿Qué datos debo buscar?

Dentro del archivo, verás varias líneas de código. Busca las que empiezan con:

DB_NAME (Nombre de la base de datos)
DB_USER (Usuario de la base de datos)
DB_PASSWORD (Contraseña de la base de datos)
DB_HOST (Servidor de la base de datos)

Verifica que estos datos sean correctos. Es muy común que se cambien mal la contraseña o el usuario desde el cPanel y no se actualicen en este archivo.

2.3. El truco del DB_HOST

A veces, el valor de DB_HOST es localhost. Pero en muchos hosting, especialmente los compartidos, el servidor de base de datos tiene un nombre distinto, como mysql.tudominio.com o localhost:3306.

¿Cómo saber cuál es el correcto? Revisa la sección Bases de datos MySQL de tu cPanel. Ahí, junto a tu base de datos, verás la información del servidor. Copia ese valor y pégalo en el DB_HOST.

[WARNING] No cambies el DB_HOST a menos que estés seguro del nuevo valor. Si lo pones mal, el error seguirá ahí. Si no estás seguro, déjalo como localhost y ve al siguiente paso.

Paso 3: Comprobar el estado de la base de datos desde cPanel

Si la configuración es correcta, el problema puede estar en la base de datos en sí. Puede que esté dañada o que haya alcanzado su límite de tamaño.

3.1. Acceder a la herramienta de bases de datos

En tu cPanel, busca la sección Bases de datos (Databases).
Haz clic en Bases de datos MySQL (MySQL Databases).
Busca tu base de datos en la lista. Al lado, verás su tamaño y el número de usuarios.

¿Tu base de datos está llena? Si el tamaño está cerca del límite, WordPress puede fallar. Si es así, necesitas liberar espacio (borrando revisiones de entradas, spam de comentarios, etc.) o contactar a tu proveedor para aumentar el límite.

3.2. Reparar la base de datos

cPanel tiene una herramienta de reparación muy útil.

En la misma sección de Bases de datos MySQL, busca la pestaña o botón que dice Reparar bases de datos (Repair Databases).
Selecciona tu base de datos de la lista y haz clic en Reparar (Repair).
Espera a que termine el proceso. Te dará un mensaje de éxito o error.

Este proceso es seguro y puede solucionar tablas dañadas que causan el problema.

Paso 4: Revisar los permisos de la base de datos

Un usuario de base de datos necesita tener ciertos permisos para poder leer y escribir en la base de datos. Si no los tiene, la conexión fallará.

Ve a Bases de datos MySQL en tu cPanel.
En la sección “Usuarios en la base de datos” (Users in the database), verás tu usuario y la base de datos.
Haz clic en Administrar privilegios (Manage Privileges) o en el icono de permisos.
Asegúrate de que TODOS los privilegios estén marcados. Si no, selecciona “Todos” y haz clic en “Realizar cambios” (Make Changes).

[INFO] Es muy común que al crear un usuario, se le asignen permisos parciales. Asegurarse de que tenga todos los privilegios es una solución frecuente para este error.

Paso 5: La solución definitiva: Cambiar la contraseña de la base de datos

Si todo lo anterior ha fallado, es hora de hacer un cambio de contraseña. Esto fuerza a que el sistema se reinicie y actualice la conexión.

5.1. Cambiar la contraseña desde cPanel

Ve a Bases de datos MySQL.
En la sección “Usuarios de MySQL”, busca tu usuario y haz clic en Cambiar contraseña (Change Password).
Introduce una contraseña nueva y segura. Guárdala en un lugar seguro.
Haz clic en Cambiar.

5.2. Actualizar el archivo wp-config.php

Ahora, ve al archivo wp-config.php (como en el Paso 2) y actualiza la línea DB_PASSWORD con la nueva contraseña que acabas de crear.

Guarda el archivo y recarga tu web. Esta acción suele solucionar el problema porque obliga a la base de datos a “olvidar” la conexión anterior y aceptar la nueva.

Paso 6: Si nada funciona, contacta a tu proveedor de hosting

Si has llegado hasta aquí y el error persiste, es hora de pedir ayuda profesional. El problema puede estar en el servidor, en un firewall, o en algo que solo el equipo de soporte puede ver.

Cuando contactes a tu proveedor, ten a mano esta información:

El mensaje de error exacto.
Los pasos que ya has intentado.
Una captura de pantalla si es posible.

Ellos tienen herramientas para diagnosticar problemas a nivel de servidor que tú no puedes ver. No tengas miedo de pedir ayuda, es su trabajo.

Preguntas frecuentes (FAQ)

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

Es muy común. Si cambias la contraseña de tu cuenta de cPanel, es posible que la contraseña de la base de datos también se haya cambiado o que el archivo wp-config.php se haya desincronizado. Revisa los Pasos 2 y 5 para corregirlo.

¿Este error puede deberse a un plugin o tema?

Sí, aunque es menos común. Un plugin o tema mal codificado puede intentar hacer una consulta a la base de datos que la satura o la bloquea. Para descartarlo, puedes renombrar la carpeta wp-content/plugins a wp-content/plugins_bak desde el administrador de archivos. Si el error desaparece, el problema es un plugin. Luego, renombra los plugins de uno en uno para encontrar al culpable.

¿Qué es el “DB_HOST” y por qué es importante?

Es la dirección del servidor donde está tu base de datos. A veces es localhost (misma máquina), pero en hosting más complejos, es una dirección distinta. Ponerla mal es una causa clásica de este error.

Conclusión: Respira, es un error solucionable

El error “Error establishing a database connection” en WordPress puede ser frustrante, pero como has visto, tiene solución. Desde un simple reinicio hasta un cambio de contraseña, los pasos son sencillos y no requieren conocimientos avanzados.

Resumen rápido de la solución:

Reinicia los servicios si puedes.
Verifica el archivo wp-config.php.
Revisa el estado y repara la base de datos.
Comprueba los permisos del usuario.
Cambia la contraseña de la base de datos.
Contacta a tu hosting si nada funciona.

[INFO] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el proceso es muy similar, pero el acceso al panel se hace a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, las herramientas de base de datos y archivos están en el menú lateral, y la lógica de solución es la misma: verificar credenciales, permisos y estado de la base de datos.

Espero que esta guía te haya sido de gran ayuda. Con un poco de paciencia, tendrás tu web funcionando de nuevo en muy poco tiempo. ¡Mucho ánimo!