Cómo corregir el error de conexión a base de datos en Joomla desde cPanel

Cuando Joomla muestra un error de conexión a base de datos, normalmente el sitio no puede leer el archivo configuration.php, la contraseña MySQL cambió o el usuario perdió permisos sobre la base. En hosting compartido casi siempre puedes confirmar y corregir esos puntos desde cPanel.

Esta guía te ayuda a revisar los datos correctos, comparar usuario y base de datos, ajustar permisos y probar el sitio sin usar acceso de servidor.

Antes de empezar

Ten a la mano:

• Acceso a cPanel de la cuenta donde está instalado Joomla.
• Ruta del sitio, por ejemplo public_html o la carpeta del dominio adicional.
• Un respaldo reciente antes de editar configuration.php.
• El dominio o subdominio donde aparece el error.

Confirma el mensaje y evita cambios a ciegas

1. Abre el sitio en una ventana privada del navegador.
2. Copia el mensaje exacto que aparece, por ejemplo Error displaying the error page: Application Instantiation Error o un aviso de conexión MySQL.
3. Confirma si también falla /administrator.

Si el sitio y el panel de administración fallan al mismo tiempo, el problema suele estar en la conexión de Joomla con MySQL. Si solo falla una sección, primero revisa extensiones, plantilla o caché de Joomla.

Revisa los datos de conexión en configuration.php

1. Entra a cPanel y abre Administrador de archivos.
2. Navega a la carpeta donde vive Joomla.
3. Descarga una copia de configuration.php antes de editarlo.
4. Abre el archivo con Editar y localiza estas líneas:

No publiques estos datos en capturas ni tickets abiertos. Si necesitas pedir ayuda, comparte solo el mensaje de error y confirma que ya comparaste usuario, base y permisos.

Compara esos datos con Bases de datos MySQL®

1. Regresa a la página principal de cPanel.
2. Abre Bases de datos MySQL® o Asistente de base de datos.
3. Busca el nombre de base de datos que aparece en $db.
4. Busca el usuario que aparece en $user.
5. Confirma que ese usuario esté asignado a esa base de datos.

El prefijo de cPanel importa. Si configuration.php dice usuario_joomla pero cPanel muestra cuenta_joomla, Joomla intentará entrar con un usuario que no existe en esa cuenta.

Corrige usuario, contraseña o permisos desde cPanel

Haz solo la corrección que coincida con lo que encontraste. Cambiar todo al mismo tiempo puede crear más dudas al probar.

Si el usuario MySQL no existe

Crea un usuario nuevo desde Bases de datos MySQL® y asígnalo a la base de Joomla. Después actualiza $user y $password en configuration.php con los datos nuevos.

Si la contraseña cambió

Define una contraseña nueva para el usuario MySQL desde cPanel. Copia esa misma contraseña en $password dentro de configuration.php y guarda el archivo.

Si faltan privilegios

En Bases de datos MySQL®, asigna el usuario a la base y marca los privilegios que requiere Joomla. En la mayoría de instalaciones normales conviene usar TODOS LOS PRIVILEGIOS para ese usuario y esa base.

Prueba el sitio y el panel de Joomla

1. Guarda configuration.php en Administrador de archivos.
2. Abre el dominio en una ventana privada.
3. Entra a /administrator y confirma que cargue el formulario de acceso.
4. Si el error continúa, limpia caché de Joomla desde el panel cuando puedas entrar, o revisa si el archivo quedó con espacios, comillas dañadas o datos copiados incompletos.

Si después de corregir credenciales aparece un error 500, restaura la copia de configuration.php y repite el cambio con cuidado. Un carácter extra dentro del archivo puede romper la carga de Joomla.

Errores comunes

• Joomla muestra el mismo error después de guardar → la base o el usuario no coinciden con el prefijo de cPanel → copia los nombres completos tal como aparecen en Bases de datos MySQL®.
• El panel /administrator tampoco carga → Joomla no puede abrir la base de datos → confirma $host, $user, $password y $db en configuration.php.
• Aparece error 500 después de editar → el archivo quedó con una comilla o carácter incorrecto → restaura el respaldo y vuelve a editar solo una línea.

Verificación final

• El sitio público abre sin mensaje de conexión MySQL.
• /administrator carga el formulario de acceso de Joomla.
• El usuario MySQL está asignado a la base correcta en cPanel.
• configuration.php conserva los nombres completos con prefijo de cPanel.