Practical MySQL & MariaDB

Como Corrigir o Erro “Access Denied for User” do MySQL (ERROR 1045) – Guia Completo de Solução de Problemas

Erros e Solução de Problemas
目次

1. Introdução

O erro “mysql access denied for user” é um problema comum frequentemente encontrado por usuários do MySQL. Esse erro significa que o acesso ao banco de dados foi negado, sendo necessária a configuração correta ou ajustes de permissões.

O Que Você Vai Aprender Neste Artigo

  • Você entenderá as causas do erro e poderá aplicar as soluções adequadas.
  • Você aprenderá métodos eficientes para configurar as opções do MySQL e gerenciar usuários por meio de instruções passo a passo, amigáveis para iniciantes.

Público‑Alvo

  • Iniciantes que acabaram de começar a usar o MySQL
  • Usuários intermediários que enfrentam dificuldades na solução de erros
  • Engenheiros que desejam compreender a causa raiz do problema

Este artigo explica de forma abrangente os detalhes do erro, suas causas, soluções e estratégias de prevenção.

2. O Que é o Erro “Access Denied for User”?

Significado da Mensagem de Erro

O erro “Access denied for user” no MySQL ocorre quando a autenticação falha. O formato geral desse erro é o seguinte:

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

Partes Importantes do Erro

  • 'username' : O nome de usuário do MySQL que está causando o problema
  • 'hostname' : O host que está tentando se conectar (ex.: localhost, endereço IP)
  • (using password: YES) : Indica que a autenticação por senha está sendo usada

Esse erro costuma ser causado por problemas relacionados à autenticação do usuário ou às permissões.

Situações Comuns em que o Erro Ocorre

Esse erro costuma aparecer nos seguintes casos:

  1. Imediatamente após criar um novo usuário – Ocorre quando as permissões não foram configuradas corretamente.
  2. Informações de conexão da aplicação incorretas – Especialmente quando credenciais armazenadas desatualizadas estão sendo usadas.
  3. Restrições de host configuradas – Conexões de hosts não autorizados são rejeitadas.

Explicação para Iniciantes

O “host” refere‑se ao dispositivo ou servidor que está tentando se conectar ao MySQL. Por exemplo, localhost refere‑se ao computador atual em que você está trabalhando.

3. Principais Causas

Nome de Usuário ou Senha Incorretos

A causa mais comum é um nome de usuário ou senha incorretos.

Erros Comuns

  • Credenciais incorretas foram escritas no arquivo de configuração.
  • A aplicação está usando credenciais desatualizadas.

Como Verificar

Use o comando a seguir para confirmar que você consegue fazer login com o nome de usuário e senha corretos.

mysql -u username -p

Quando solicitado, digite a senha correta. Se estiver errada, o login falhará.

Privilégios Insuficientes ao Usuário

No MySQL, as permissões de acesso são configuradas por usuário. Se os privilégios forem insuficientes, o acesso ao banco de dados será negado.

Como Verificar os Privilégios

Use o comando a seguir para verificar os privilégios do usuário:

SHOW GRANTS FOR 'username'@'hostname';

Se os privilégios necessários não estiverem concedidos, você deverá atribuir as permissões adequadas.

Incompatibilidade de Nome de Host

No MySQL, os usuários podem ser configurados para permitir conexões apenas de hosts específicos (ex.: localhost, endereço IP). Se o nome do host não coincidir, a conexão será rejeitada.

Como Verificar as Configurações de Host

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

Esse comando exibe a lista de hosts permitidos para o usuário especificado. Se o seu host atual não estiver incluído, a conexão será negada.

Problemas na Configuração do MySQL

Problemas no arquivo de configuração do MySQL (geralmente my.cnf ou my.ini) também podem causar esse erro. Em particular, a configuração bind-address pode afetar a conectividade.

Como Verificar a Configuração

Abra o arquivo de configuração e verifique a definição de bind-address.

bind-address = 127.0.0.1

Nesse caso, conexões remotas não são permitidas, portanto o acesso externo será rejeitado.

Se desejar permitir conexões remotas, altere para bind-address = 0.0.0.0 e reinicie o MySQL.

4. Soluções

Verificar Nome de Usuário e Senha

Primeiro, confirme que suas credenciais atuais estão corretas.

Procedimento

  1. Execute o comando a seguir e tente fazer login com o nome de usuário e senha corretos.
    mysql -u username -p
  1. Se não conseguir fazer login mesmo com a senha correta, será necessário redefinir a senha.

Redefinir a Senha

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

Configurar Privilégios de Usuário

Verifique se os privilégios necessários estão configurados e conceda-os caso estejam ausentes.

Verificar Privilégios

SHOW GRANTS FOR 'username'@'hostname';

Conceder Privilégios

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

Isso concede todos os privilégios ao usuário e aplica as alterações.

Modificar Configurações de Nome de Host

Se o erro for causado por restrições de host, configure as definições de host apropriadas.

Verificar Configurações de Host

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

Atualizar Configurações de Host

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

Especificar % permite conexões de todos os hosts. No entanto, como isso pode introduzir riscos de segurança, recomenda-se especificar um endereço IP específico sempre que possível.

Modificar Configuração do MySQL

Edite o arquivo de configuração (my.cnf ou my.ini) para configurar adequadamente as restrições de conexão.

Editar o Arquivo de Configuração

Para Linux:

sudo nano /etc/mysql/my.cnf

Para Windows:

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

(X.X varia dependendo da sua versão do MySQL)

Verificar a Configuração bind-address

bind-address = 127.0.0.1

Esta configuração permite conexões apenas do localhost. Para habilitar conexões remotas, altere-a da seguinte forma:

bind-address = 0.0.0.0

Reiniciar o MySQL para Aplicar as Alterações

sudo systemctl restart mysql

Ou (para Windows):

net stop MySQL
net start MySQL

Usando esses métodos, você pode resolver a maioria dos erros “Access denied for user”. Em seguida, vamos revisar as perguntas frequentes (FAQ).

5. FAQ (Perguntas Frequentes)

Q1: O que devo fazer se o erro não desaparecer?

A1: Verifique os logs de erro.

Para identificar a causa do erro, revisar os logs de erro do MySQL é eficaz.

Para Linux

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

Para Windows

O caminho padrão do log de erro é um dos seguintes:

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

Revise os logs e resolva o problema com base na mensagem de erro específica.

Q2: Por que o erro ocorre apenas para um usuário específico?

A2: Pode ser causado pelas configurações de host ou privilégios do usuário.

Verifique os privilégios do usuário relevante com o comando a seguir:

SHOW GRANTS FOR 'username'@'hostname';

Também verifique se a configuração de host está correta:

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

Se a configuração de host estiver incorreta, modifique-a adequadamente:

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

Q3: Como posso redefinir a senha se esqueci as informações de login?

A3: Inicie o MySQL em modo seguro e redefina a senha.

Para Linux

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

Em seguida, redefina a senha usando o comando a seguir:

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

Reinicie o MySQL:

sudo systemctl restart mysql

Para Windows

  1. Abra o Prompt de Comando como administrador e inicie o MySQL em modo seguro.
    net stop MySQL
mysqld --skip-grant-tables
  1. Em outra janela do Prompt de Comando, conecte-se ao MySQL e redefina a senha.
    mysql -u root
UPDATE mysql.user SET authentication_string=PASSWORD('new_password') WHERE User='root';
FLUSH PRIVILEGES;
EXIT;
  1. Reinicie o MySQL.
    net start MySQL

Seguindo este procedimento, você pode redefinir uma senha esquecida.

Esta seção de FAQ abordou o que fazer se o erro persistir e respondeu perguntas comuns. Finalmente, vamos revisar o resumo.

6. Resumo

Este artigo forneceu uma explicação detalhada do erro “Access denied for user” no MySQL. Este erro é comumente causado por credenciais de autenticação incorretas, privilégios insuficientes, configuração de host incorreta ou erros de configuração do MySQL.

Pontos Principais Deste Artigo

  1. Identifique a Causa do Erro
  • Verifique se um nome de usuário ou senha incorreto está sendo usado.
  • Verifique os privilégios com SHOW GRANTS FOR 'username'@'hostname'; .
  • Verifique as configurações de host usando SELECT Host, User FROM mysql.user WHERE User = 'username'; .
  1. Aplique a Solução Adequada
  • Redefina a senha usando o comando SET PASSWORD.
  • Corrija os privilégios usando o comando GRANT ALL PRIVILEGES.
  • Modifique a configuração bind-address adequadamente para permitir conexões remotas.
  1. Se o Problema Persistir, Verifique os Logs de Erro
  • Linux: /var/log/mysql/error.log
  • Windows: C:\ProgramData\MySQL\MySQL Server X.X\error.log

Melhores Práticas para Prevenir Recorrência

  • Gerenciamento Adequado de Usuários
  • Atribua privilégios apropriados a cada usuário e remova usuários desnecessários.
  • Esclareça a Configuração de Host
  • Evite permitir acesso de todos os hosts (por exemplo, '%' ) a menos que necessário, pois isso representa riscos de segurança. Restrinja o acesso a hosts específicos sempre que possível.
  • Realize Backups Regulares
  • Use mysqldump regularmente para prevenir problemas causados por erros de configuração.

Considerações Finais

O erro “Access denied for user” pode parecer difícil para iniciantes, mas seguindo os procedimentos neste artigo, a maioria dos problemas pode ser resolvida. Se o problema persistir, revise os logs de erro e verifique novamente sua configuração e permissões.