Solucionar error 'Access denied for user' en MySQL: cPanel y Plesk

Este es uno de los errores más comunes y frustrantes al administrar un sitio web: intentas conectar tu aplicación (WordPress, Joomla, PrestaShop, etc.) a su base de datos y te encuentras con el mensaje "Access denied for user 'usuario'@'localhost' (using password: YES)" o una variante similar.

No te preocupes. Este error en MySQL no siempre significa que tus datos estén perdidos o que el servidor esté roto. Generalmente, es un problema de permisos o de credenciales mal escritas. Como técnico de soporte, te guiaré paso a paso para resolverlo, tanto si usas cPanel como Plesk. También veremos cómo actuar si tu panel es Syspanel (anteriormente conocido como HestiaCP, cuyo acceso es por el puerto 2106).

¿Qué significa el error "Access denied for user"?

El mensaje "Access denied" es la forma que tiene el servidor MySQL de decirte: "No te conozco o no te dejo entrar". Las causas más frecuentes son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos están mal escritos en el archivo de configuración de tu sitio (ej. wp-config.php en WordPress).
Usuario no vinculado a la base de datos: El usuario de MySQL existe, pero no tiene permisos para acceder a la base de datos específica que estás usando.
Host incorrecto: El usuario está configurado para conectarse solo desde localhost, pero tu aplicación intenta conectarse desde otra IP o nombre de host.
Contraseña recién cambiada: Si cambiaste la contraseña de la base de datos en el panel de control, pero no actualizaste el archivo de configuración de tu web.
Corrupción de privilegios: En casos raros, la tabla de permisos de MySQL se daña.

Vamos a solucionarlo. Sigue los pasos en orden, del más simple al más avanzado.

Paso 1: Verifica tus credenciales en el archivo de configuración

Antes de tocar nada en el panel de control, asegúrate de que los datos que estás usando son los correctos. Este es el error más común.

¿Dónde está el archivo?

WordPress: wp-config.php en la raíz de tu sitio.
Joomla: configuration.php.
PrestaShop: app/config/parameters.php.
Drupal: sites/default/settings.php.

Abre el archivo con un editor de texto (Notepad++, Sublime Text, o el editor de archivos de cPanel/Plesk). Busca las líneas que definen la conexión a la base de datos. Deberías ver algo como:

define('DB_NAME', 'tu_usuario_basededatos');
define('DB_USER', 'tu_usuario_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Compara estos datos con los que tienes en tu panel de control:

Nombre de la base de datos: En cPanel, suele ser tu_cpanel_usuario_nombre_db. En Plesk, es el nombre que le diste.
Nombre de usuario: Similar al anterior.
Contraseña: Asegúrate de que no tenga espacios al inicio o al final. Cópiala exactamente.
Host: Casi siempre es localhost. Si tu web usa un servicio de base de datos externo, aquí iría la IP o el nombre del servidor.

[WARNING] ¡Cuidado con los caracteres especiales! Si tu contraseña contiene caracteres como $, &, %, #, ' o ", pueden romper la sintaxis del archivo PHP. En ese caso, cambia la contraseña por una más simple (solo letras y números) desde el panel de control y actualiza el archivo.

Si todo coincide y el error persiste, pasa al siguiente paso.

Paso 2: Verifica los permisos del usuario en la base de datos (cPanel, Plesk, Syspanel)

A veces, el usuario existe y la contraseña es correcta, pero no tiene "permiso" para tocar la base de datos. Es como tener la llave de una puerta, pero la cerradura está cambiada.

En cPanel

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos y haz clic en MySQL® Databases.
Desplázate hacia abajo hasta la sección Añadir usuario a la base de datos.
Selecciona el usuario y la base de datos correspondientes.
Haz clic en Añadir.
En la siguiente pantalla, marca TODOS LOS PRIVILEGIOS (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Haz clic en Realizar cambios.

En Plesk

Ve a Sitios web y dominios y selecciona tu dominio.
Haz clic en Bases de datos.
Localiza tu base de datos y haz clic en el icono de Gestión de usuarios (suele ser un engranaje o un icono de personas).
Verás una lista de usuarios. Si tu usuario no aparece, haz clic en Añadir usuario a la base de datos.
Si ya aparece, haz clic en el nombre del usuario y asegúrate de que tiene marcados Todos los privilegios.
Guarda los cambios.

En Syspanel (HestiaCP, puerto 2106)

Accede a tu panel Syspanel: https://tudominio.com:2106.
Ve a la sección Bases de datos.
Busca tu base de datos en la lista. A la derecha, verás un icono de Editar (un lápiz) o Gestionar permisos.
Haz clic y verifica que el usuario esté añadido. Si no, añádelo desde la opción Añadir usuario.
Marca la casilla Todos los privilegios y guarda.

[TIP] En Syspanel, es muy común que al crear la base de datos no se asigne automáticamente el usuario. Revisa siempre este paso.

Después de hacer esto, prueba a conectar tu aplicación de nuevo.

Paso 3: Cambia la contraseña del usuario de MySQL

Si los permisos están bien, pero el error persiste, la contraseña podría estar mal escrita o tener caracteres problemáticos. La solución más segura es cambiarla.

En cPanel

Ve a MySQL® Databases.
En la sección Usuarios actuales, busca tu usuario.
Haz clic en Cambiar contraseña.
Usa el generador de contraseñas o escribe una nueva. Anótala exactamente.
Haz clic en Cambiar.

En Plesk

Ve a Sitios web y dominios > tu dominio > Bases de datos.
Haz clic en el nombre de la base de datos.
En la pestaña Usuarios, busca tu usuario y haz clic en Cambiar contraseña.
Introduce la nueva contraseña y confírmala. Guárdala.

En Syspanel (HestiaCP, puerto 2106)

En la lista de bases de datos, haz clic en el icono de Editar (lápiz) junto a tu base de datos.
Busca la opción Cambiar contraseña del usuario.
Introduce la nueva contraseña y guárdala.

Ahora, actualiza el archivo de configuración de tu web (el wp-config.php o similar) con la nueva contraseña. Guarda el archivo y recarga la página.

Paso 4: Verifica el "Host" del usuario (el error de localhost vs. IP)

MySQL distingue de dónde se conecta el usuario. Si tu aplicación se conecta desde el mismo servidor, el host debe ser localhost. Si usas un servicio como Remote MySQL (para conectar desde otro servidor o tu PC), el host debe ser la IP desde la que te conectas.

En cPanel

Ve a MySQL® Databases.
En la sección Usuarios actuales, busca tu usuario.
Al lado del nombre, verás el Host. Normalmente es localhost.
Si necesitas cambiarlo, no es posible directamente desde cPanel. Tendrías que eliminar el usuario y crearlo de nuevo con el host correcto, o usar phpMyAdmin (ver Paso 5).

En Plesk

Ve a la base de datos y a la pestaña Usuarios.
Haz clic en el nombre del usuario. Verás el campo Host.
Puedes cambiarlo directamente. Si tu web está en el mismo servidor, déjalo como localhost. Si es para una conexión remota, pon el % (para permitir cualquier host) o la IP específica.

En Syspanel (HestiaCP, puerto 2106)

Al editar el usuario, busca el campo Host.
Cambia a localhost o a % según necesites.

Paso 5: Solución avanzada: Reparar privilegios con phpMyAdmin

Si nada de lo anterior funciona, es posible que la tabla de privilegios de MySQL esté corrupta. Podemos repararla fácilmente desde phpMyAdmin.

Accede a phpMyAdmin desde tu panel de control (en cPanel está en la sección Bases de Datos, en Plesk suele ser un enlace directo en la base de datos, en Syspanel también está disponible).
Una vez dentro, NO selecciones ninguna base de datos. Busca la pestaña SQL (en la parte superior).
En el cuadro de texto, escribe exactamente este comando SQL:
```
FLUSH PRIVILEGES;
```
Haz clic en Continuar o en el botón Ejecutar.

Este comando le dice a MySQL que recargue y recompile los permisos desde cero. Después de ejecutarlo, vuelve a tu web y pruébala.

[INFO] Si el error persiste después de FLUSH PRIVILEGES, puede ser un problema más grave del servidor. Contacta con tu proveedor de hosting y diles que ya has verificado credenciales, permisos y has ejecutado el flush.

FAQ MySQL: Preguntas frecuentes sobre "Access denied"

P: ¿Por qué veo "Access denied for user 'root'@'localhost'"?
R: En la mayoría de los hostings compartidos, el usuario root no está disponible por seguridad. Debes usar el usuario específico que creaste para tu base de datos. Si estás en un VPS o servidor dedicado y olvidaste la contraseña de root, deberás resetearla desde la terminal (consulta a tu administrador).

P: Cambié la contraseña en cPanel, pero el error sigue. ¿Qué hago?
R: Asegúrate de que el archivo wp-config.php (o el que corresponda) se haya guardado correctamente con la nueva contraseña. A veces, el editor de archivos de cPanel no guarda los cambios si hay un error de permisos. Descarga el archivo, edítalo en tu PC y súbelo de nuevo.

P: Mi sitio funciona, pero de repente aparece el error. ¿Qué pasó?
R: Puede que hayas cambiado la contraseña sin querer, o que el administrador del servidor haya realizado algún cambio. También es posible que hayas superado el límite de conexiones simultáneas a la base de datos. Revisa el log de errores de tu web para más detalles.

P: ¿Puedo usar el mismo usuario para varias bases de datos?
R: Sí, es posible. En cPanel, al añadir un usuario a una base de datos, puedes seleccionar el mismo usuario para otra. En Plesk y Syspanel, el proceso es similar. Solo asegúrate de que tenga los permisos necesarios en cada una.

P: El error dice "using password: NO". ¿Qué significa?
R: Significa que tu aplicación está intentando conectarse sin enviar una contraseña. Revisa el archivo de configuración; probablemente la línea de la contraseña está vacía o mal escrita (ej. falta una comilla).

P: Estoy en Syspanel (HestiaCP) y no encuentro la opción de añadir usuario a la base de datos.
R: Recuerda que el acceso a Syspanel es por el puerto 2106. Una vez dentro, ve a Bases de datos, haz clic en el nombre de tu base de datos y luego en la pestaña Usuarios. Ahí podrás añadir o gestionar los usuarios existentes.

Conclusión

El error "Access denied for user" es una señal de que la comunicación entre tu aplicación y la base de datos está rota. La mayoría de las veces se soluciona con una simple verificación de credenciales o reasignando permisos desde el panel de control (cPanel, Plesk o Syspanel). Si has seguido todos los pasos de esta guía y el error persiste, es momento de contactar al soporte técnico de tu hosting, ya que podría ser un problema interno del servidor MySQL.

No te desanimes. Este error es un clásico y, con un poco de paciencia, se resuelve rápido. ¡Buena suerte!