En qué consiste este error
Cuando visitas tu sitio WordPress y aparece el mensaje "Error establishing a database connection", significa que WordPress no puede conectar con el servidor MySQL. La causa habitual que se asume es que las credenciales del archivo wp-config.php no coinciden con las de cPanel, pero no es la única y, en muchos casos, no es la correcta.
Las tres causas más frecuentes
Credenciales incorrectas en
wp-config.php(nombre de BD, usuario o contraseña).La base de datos ha sido eliminada de cPanel (por error, al limpiar huecos para crear otra, o por confusión entre "usuario de BD" y "base de datos").
Problema del servidor MySQL (caída temporal del servicio). En este caso suele verse afectado más de un sitio a la vez. Consulta siempre status.tropicalserver.com antes de tocar nada.
Antes de modificar nada, diagnostica la causa
El primer impulso suele ser abrir wp-config.php y cambiar credenciales. No lo hagas hasta estar seguro de que ese es el problema: si tienes varios dominios en la misma cuenta, tocar un wp-config.php equivocado puede romper otros sitios. Sigue este orden:
Paso 1: Comprueba si la base de datos existe en cPanel
Accede a cPanel > Bases de datos MySQL y presta mucha atención a la distinción:
La sección "Bases de datos actuales" lista las bases de datos propiamente dichas.
La sección "Usuarios actuales" lista los usuarios MySQL (que tienen permisos para conectarse a una o varias BD).
Es muy habitual que un usuario y una base de datos tengan el mismo nombre (por ejemplo cuenta_wp123). Ver el nombre en la lista de usuarios no significa que la base de datos exista. Revisa ambas listas por separado.
Paso 2: Localiza el wp-config.php correcto
Abre el archivo wp-config.php del WordPress afectado (no el de otro dominio de la misma cuenta) y apunta el valor de DB_NAME. Ese es el nombre exacto que debería aparecer en la lista de Bases de datos actuales de cPanel.
Si tu dominio usa una carpeta distinta (p. ej. public_html/wp/ o un subdirectorio), el wp-config.php correcto está en esa ruta específica.
Paso 3: Compara con el histórico de JetBackup
Entra en cPanel > JetBackup 5 > Database Backups y busca la base de datos por nombre. Si ves que:
La base de datos tiene copias recientes pero no aparece en "Bases de datos actuales" de cPanel, es que ha sido eliminada. Se puede restaurar desde la última copia antes del borrado.
Las copias se detienen en una fecha concreta y a partir de ahí aparecen copias de otra BD con nombre distinto, es muy probable que hayas borrado la original y creado una nueva con otro nombre.
Qué hacer si la base de datos ha sido eliminada
Abre un ticket de soporte indicando el nombre exacto de la base de datos y te ayudamos a restaurar la copia más reciente. Ten en cuenta dos detalles importantes:
Tu plan tiene un número máximo de bases de datos. Si ya tienes el cupo lleno, antes de restaurar habrá que liberar una BD que no uses.
Si has creado una base de datos nueva tras borrar la original, comprueba si WordPress ya está trabajando sobre la nueva (datos recientes) o sobre la antigua (datos hasta la fecha del borrado). Decide con qué versión quieres quedarte antes de la restauración.
Qué hacer si solo son credenciales incorrectas
Si la base de datos existe en cPanel y coincide con DB_NAME, revisa:
DB_USER: debe estar en la lista de "Usuarios actuales" de cPanel y tener permisos sobre
DB_NAME(sección "Usuarios actuales en base de datos").DB_PASSWORD: si no la recuerdas, desde cPanel > Bases de datos MySQL puedes establecer una nueva contraseña para el usuario MySQL y luego actualizar el
wp-config.php.DB_HOST: en la inmensa mayoría de casos es
localhost.
Qué NO hacer
No modifiques el
wp-config.phpsin antes verificar en cPanel si la base de datos existe. Cambiar credenciales no devuelve a la vida una BD borrada.No elimines bases de datos "que creas que no usas" sin comprobar antes, desde Softaculous > All Installations, a qué instalación pertenece cada una.
No toques
wp-config.phpde otros dominios de la misma cuenta pensando que afectan al sitio caído: cada sitio tiene su propio archivo.
Recurso relacionado
Si necesitas guía paso a paso para restaurar una BD desde JetBackup, consulta el artículo Guía de uso de JetBackup 5 para restaurar datos y bases de datos del backup de tu cuenta.