O que fazer quando aparece o erro 'Access denied for user' ao conectar no banco de dados

Erro "Access denied for user" ao conectar no banco de dados: o que fazer

Oi! Eu sou a Sensei da GeHost 🥋 e vou te ajudar a resolver esse errinho chato que aparece quando o site tenta "conversar" com o banco de dados mas a senha ou o usuário não batem. Calma, é um dos problemas mais comuns e, na grande maioria das vezes, é rapidinho de resolver. Vamos passo a passo, sem enrolação.

Por que esse erro aparece?

O erro "Access denied for user" (algo como "Acesso negado para o usuário") acontece quando o seu site tenta acessar o banco de dados usando um usuário, senha ou nome de banco que estão errados, desatualizados ou que perderam a permissão de acesso. É a mesma lógica de tentar entrar num aplicativo com a senha errada — o "cadeado" trava o acesso até os dados baterem certinho.

As causas mais comuns são:

• Alguém alterou a senha do banco de dados, mas esqueceu de atualizar no arquivo de configuração do site (ex.: wp-config.php em sites WordPress).
• O site foi migrado/restaurado de outro lugar e o arquivo de configuração ainda aponta pros dados antigos do banco.
• O usuário do banco perdeu a permissão (privilégio) de acesso àquele banco específico.
• Erro de digitação no nome do usuário ou do banco (um caractere a mais já quebra tudo).

Passo a passo pra resolver

1. Acesse o seu cPanel pelo painel do cliente (painel.gehost.com.br) ou direto pela URL de acesso que você recebeu.
   
2. Dentro do cPanel, procure a seção "Bancos de Dados MySQL". É lá que ficam os bancos, os usuários e as permissões de cada um.
   
3. Confirme se o banco e o usuário existem. Veja se o nome do banco de dados que o site está usando aparece na lista, e se o usuário associado a ele também existe.
4. Confira (ou redefina) a senha do usuário do banco. Na mesma tela, é possível alterar a senha de um usuário existente. Se você não lembra a senha atual, o mais seguro é criar uma nova senha ali mesmo.
5. Garanta que o usuário está vinculado ao banco com todos os privilégios. Ter usuário e banco criados não basta — eles precisam estar "conectados" um ao outro, com permissão total (all privileges), senão o acesso continua negado.
6. Atualize o arquivo de configuração do site com os dados corretos (nome do banco, nome do usuário e a senha nova). Em sites WordPress, esse arquivo é o wp-config.php, na raiz do site. Você pode editá-lo pelo Gerenciador de Arquivos do cPanel.
   
7. Salve as alterações e recarregue o site pra ver se o erro sumiu.

Dica da Sensei: sempre que você mudar a senha do banco direto no cPanel, lembre de atualizar o arquivo de configuração do site na mesma hora. Esquecer esse passo é a causa nº1 desse erro aparecer do nada em sites que estavam funcionando normalmente. 😉

Dica da Sensei: antes de mexer em qualquer coisa, tire uma cópia do arquivo de configuração ou faça um backup do site pelo cPanel. Assim, se algo sair diferente do esperado, dá pra voltar fácil.

Se você não é a pessoa técnica do site

Se você não se sente confortável editando esses arquivos, sem problema nenhum! Você pode nos chamar pelo suporte que a gente te orienta ou verifica isso junto com você. Só tenha em mãos o nome do site/domínio afetado pra agilizar o atendimento.

Ainda não resolveu?

Se você já conferiu tudo isso e o erro continua aparecendo, entre em contato com o nosso suporte pelo painel.gehost.com.br, contando o que já foi tentado. Assim a gente já entra direto na investigação mais a fundo, sem perder tempo repetindo os primeiros passos.