Practical MySQL & MariaDB

Cómo solucionar el error “Access Denied for User” de MySQL (ERROR 1045) – Guía completa de solución de problemas

Errores y Solución de Problemas
目次

1. Introducción

El error “mysql access denied for user” es un problema frecuente que encuentran los usuarios de MySQL. Este error indica que se ha denegado el acceso a la base de datos y que es necesario ajustar la configuración o los permisos adecuados.

Qué aprenderás en este artículo

  • Comprenderás las causas del error y podrás aplicar las soluciones correspondientes.
  • Aprenderás métodos eficientes para configurar MySQL y gestionar usuarios mediante instrucciones paso a paso, amigables para principiantes.

Público objetivo

  • Principiantes que acaban de comenzar a usar MySQL
  • Usuarios intermedios que tienen dificultades para solucionar el error
  • Ingenieros que desean entender la causa raíz del problema

Este artículo explica de forma integral los detalles del error, sus causas, soluciones y estrategias de prevención.

2. ¿Qué es el error “Access Denied for User”?

Significado del mensaje de error

El error “Access denied for user” en MySQL ocurre cuando falla la autenticación. El formato general de este error es el siguiente:

ERROR 1045 (28000): Access denied for user 'username'@'hostname' (using password: YES)

Partes importantes del error

  • 'username' : El nombre de usuario de MySQL que genera el problema
  • 'hostname' : El host que intenta conectarse (p. ej., localhost, dirección IP)
  • (using password: YES) : Indica que se está usando autenticación por contraseña

Este error suele deberse a problemas relacionados con la autenticación del usuario o con sus permisos.

Situaciones comunes en las que ocurre el error

Este error se presenta frecuentemente en los siguientes casos:

  1. Inmediatamente después de crear un nuevo usuario – Ocurre cuando los permisos no están configurados correctamente.
  2. Información de conexión de la aplicación incorrecta – Especialmente cuando se utilizan credenciales almacenadas desactualizadas.
  3. Restricciones de host configuradas – Las conexiones desde hosts no autorizados son rechazadas.

Explicación para principiantes

El “host” se refiere al dispositivo o servidor que intenta conectarse a MySQL. Por ejemplo, localhost hace referencia a la computadora en la que estás trabajando.

3. Causas principales

Nombre de usuario o contraseña incorrectos

La causa más frecuente es un nombre de usuario o una contraseña incorrectos.

Errores comunes

  • Las credenciales están mal escritas en el archivo de configuración.
  • La aplicación está usando credenciales desactualizadas.

Cómo verificar

Utiliza el siguiente comando para comprobar que puedes iniciar sesión con el nombre de usuario y la contraseña correctos.

mysql -u username -p

Cuando se solicite, ingresa la contraseña correcta. Si es incorrecta, el inicio de sesión fallará.

Privilegios insuficientes del usuario

En MySQL, los permisos de acceso se configuran por usuario. Si los privilegios son insuficientes, se denegará el acceso a la base de datos.

Cómo comprobar los privilegios

Ejecuta el siguiente comando para revisar los privilegios del usuario:

SHOW GRANTS FOR 'username'@'hostname';

Si no se han concedido los privilegios necesarios, deberás asignar los permisos adecuados.

Incongruencia del nombre de host

En MySQL, los usuarios pueden estar configurados para permitir conexiones solo desde hosts específicos (p. ej., localhost, dirección IP). Si el nombre de host no coincide, la conexión será rechazada.

Cómo comprobar la configuración del host

SELECT Host, User FROM mysql.user WHERE User = 'username';

Este comando muestra una lista de hosts permitidos para el usuario especificado. Si tu host actual no está incluido, la conexión será denegada.

Problemas de configuración de MySQL

Problemas en el archivo de configuración de MySQL (usualmente my.cnf o my.ini) también pueden generar este error. En particular, la opción bind-address puede afectar la conectividad.

Cómo revisar la configuración

Abre el archivo de configuración y verifica la opción bind-address.

bind-address = 127.0.0.1

En este caso, las conexiones remotas no están permitidas, por lo que el acceso externo será rechazado.

Si deseas habilitar conexiones remotas, cambia la línea a bind-address = 0.0.0.0 y reinicia MySQL.

4. Soluciones

Verificar Nombre de Usuario y Contraseña

Primero, confirma que tus credenciales actuales sean correctas.

Procedimiento

  1. Ejecuta el siguiente comando e intenta iniciar sesión con el nombre de usuario y contraseña correctos.
    mysql -u username -p
  1. Si no puedes iniciar sesión incluso con la contraseña correcta, necesitas restablecer la contraseña.

Restablecer la Contraseña

SET PASSWORD FOR 'username'@'hostname' = PASSWORD('new_password');

Configurar Privilegios de Usuario

Verifica si los privilegios necesarios están configurados y otórgalos si faltan.

Verificar Privilegios

SHOW GRANTS FOR 'username'@'hostname';

Otorgar Privilegios

GRANT ALL PRIVILEGES ON database_name.* TO 'username'@'hostname';
FLUSH PRIVILEGES;

Esto otorga todos los privilegios al usuario y aplica los cambios.

Modificar Configuraciones de Nombre de Host

Si el error es causado por restricciones de host, configura las configuraciones de host apropiadas.

Verificar Configuraciones de Host

SELECT Host, User FROM mysql.user WHERE User = 'username';

Actualizar Configuraciones de Host

UPDATE mysql.user SET Host='%' WHERE User='username';
FLUSH PRIVILEGES;

Especificar % permite conexiones desde todos los hosts. Sin embargo, porque esto puede introducir riesgos de seguridad, se recomienda especificar una dirección IP particular cuando sea posible.

Modificar Configuración de MySQL

Edita el archivo de configuración (my.cnf o my.ini) para configurar correctamente las restricciones de conexión.

Editar el Archivo de Configuración

Para Linux:

sudo nano /etc/mysql/my.cnf

Para Windows:

C:\ProgramData\MySQL\MySQL Server X.X\my.ini

(X.X varía dependiendo de tu versión de MySQL)

Verificar la Configuración de bind-address

bind-address = 127.0.0.1

Esta configuración permite conexiones solo desde localhost. Para habilitar conexiones remotas, cámbiala de la siguiente manera:

bind-address = 0.0.0.0

Reiniciar MySQL para Aplicar Cambios

sudo systemctl restart mysql

O (para Windows):

net stop MySQL
net start MySQL

Usando estos métodos, puedes resolver la mayoría de los errores “Access denied for user”. A continuación, revisemos las preguntas frecuentes (FAQ).

5. FAQ (Preguntas Frecuentes)

P1: ¿Qué debo hacer si el error no desaparece?

R1: Verifica los registros de errores.

Para identificar la causa del error, revisar los registros de errores de MySQL es efectivo.

Para Linux

sudo cat /var/log/mysql/error.log

Para Windows

La ruta predeterminada del registro de errores es una de las siguientes:

C:\ProgramData\MySQL\MySQL Server X.X\error.log

Revisa los registros y aborda el problema basado en el mensaje de error específico.

P2: ¿Por qué ocurre el error solo para un usuario específico?

R2: Puede ser causado por las configuraciones de host del usuario o privilegios.

Verifica los privilegios del usuario relevante con el siguiente comando:

SHOW GRANTS FOR 'username'@'hostname';

También verifica si la configuración de host es correcta:

SELECT Host, User FROM mysql.user WHERE User = 'username';

Si la configuración de host es incorrecta, modifícala apropiadamente:

UPDATE mysql.user SET Host='%' WHERE User='username';
FLUSH PRIVILEGES;

P3: ¿Cómo puedo restablecer la contraseña si olvidé la información de inicio de sesión?

R3: Inicia MySQL en modo seguro y restablece la contraseña.

Para Linux

sudo systemctl stop mysql
sudo mysqld_safe --skip-grant-tables &
mysql -u root

Luego restablece la contraseña usando el siguiente comando:

UPDATE mysql.user SET authentication_string=PASSWORD('new_password') WHERE User='root';
FLUSH PRIVILEGES;
EXIT;

Reinicia MySQL:

sudo systemctl restart mysql

Para Windows

  1. Abre el Símbolo del sistema como administrador e inicia MySQL en modo seguro.
    net stop MySQL
mysqld --skip-grant-tables
  1. En otra ventana del símbolo del sistema, conéctese a MySQL y restablezca la contraseña.
    mysql -u root
UPDATE mysql.user SET authentication_string=PASSWORD('new_password') WHERE User='root';
FLUSH PRIVILEGES;
EXIT;
  1. Reinicie MySQL.
    net start MySQL

Seguir este procedimiento le permite restablecer una contraseña olvidada.

Esta sección de preguntas frecuentes abordó qué hacer si el error persiste y respondió preguntas comunes. Finalmente, revisemos el resumen.

6. Resumen

Este artículo proporcionó una explicación detallada del error “Access denied for user” en MySQL. Este error se produce comúnmente por credenciales de autenticación incorrectas, privilegios insuficientes, configuración de host incorrecta o errores en la configuración de MySQL.

Puntos clave de este artículo

  1. Identificar la causa del error
  • Verifique si se está utilizando un nombre de usuario o contraseña incorrectos.
  • Verifique los privilegios con SHOW GRANTS FOR 'username'@'hostname';.
  • Revise la configuración de hosts usando SELECT Host, User FROM mysql.user WHERE User = 'username';.
  1. Aplicar la solución adecuada
  • Restablezca la contraseña usando el comando SET PASSWORD.
  • Corrija los privilegios usando el comando GRANT ALL PRIVILEGES.
  • Modifique la configuración bind-address de forma adecuada para permitir conexiones remotas.
  1. Si el problema persiste, revise los registros de errores
  • Linux: /var/log/mysql/error.log
  • Windows: C:\ProgramData\MySQL\MySQL Server X.X\error.log

Mejores prácticas para prevenir la recurrencia

  • Gestión adecuada de usuarios
  • Asigne los privilegios apropiados a cada usuario y elimine los usuarios innecesarios.
  • Aclarar la configuración de hosts
  • Evite permitir el acceso desde todos los hosts (p. ej., '%') a menos que sea necesario, ya que representa riesgos de seguridad. Restrinja el acceso a hosts específicos siempre que sea posible.
  • Realizar copias de seguridad regulares
  • Use mysqldump de forma regular para prevenir problemas causados por errores de configuración.

Reflexiones finales

El error “Access denied for user” puede parecer difícil para los principiantes, pero siguiendo los procedimientos de este artículo la mayoría de los problemas pueden resolverse. Si el problema persiste, revise los registros de errores y vuelva a comprobar su configuración y permisos.