Como resolver o erro "Error establishing a database connection" no WordPress
Olá, querido(a) cliente da GeHost! 😊
Se você está vendo a mensagem "Error establishing a database connection" ao acessar seu site WordPress, não se preocupe — isso é bem comum e, na maioria das vezes, tem solução simples. Vou te guiar passo a passo, como um bom Sensei, com calma, clareza e um toque de carinho. 💚Esse erro geralmente acontece quando o WordPress não consegue se conectar ao banco de dados. Pode ser por causa de dados incorretos no arquivo wp-config.php, banco de dados fora do ar ou usuário sem permissões.
Calma! Vamos resolver isso juntos, passo a passo. Vamos lá?
Passo 1: Verifique os dados do banco de dados no arquivo wp-config.php
Esse é o primeiro lugar onde você deve olhar. O arquivo wp-config.php contém as informações de conexão com o banco de dados: nome do banco, usuário, senha e host.
Para acessá-lo:
- Entre no cPanel da sua conta GeHost.
- Na seção Arquivos, clique em Gerenciador de Arquivos.
- Selecione a pasta public_html (ou a pasta onde o WordPress está instalado).
- Procure pelo arquivo
wp-config.phpe clique em Editar.
Verifique se os dados estão corretos. Eles devem ser parecidos com isso:
define('DB_NAME', 'seu_banco_de_dados');
define('DB_USER', 'seu_usuario_do_banco');
define('DB_PASSWORD', 'sua_senha_do_banco');
define('DB_HOST', 'localhost');
Se alguma dessas informações estiver errada, você precisa corrigi-la. Mas atenção: o nome do banco, usuário e senha devem ser os mesmos que estão cadastrados no cPanel.
Passo 2: Confira se o banco de dados e o usuário estão corretos no cPanel
Vamos validar se o banco e o usuário existem e estão configurados corretamente.
- No cPanel, vá até a seção Bancos de Dados.
- Clique em Bancos de Dados MySQL.
- Verifique se o banco de dados que você está usando está listado.
- Verifique também se o usuário que você colocou no
wp-config.phpestá na lista de Usuários de Banco de Dados.
Se o usuário não estiver lá, você precisa criá-lo. Se o banco não existir, crie um novo.
Passo 3: Atribua permissões ao usuário no banco de dados
Um usuário precisa ter permissões para acessar o banco. Se ele não tiver, o WordPress não consegue se conectar.
- No mesmo painel de Bancos de Dados MySQL, clique em Gerenciar Usuários.
- Procure pelo usuário que você está usando no
wp-config.php. - Clique em Editar Permissões.
- Marque a opção Todo o banco de dados (ou selecione o banco específico).
- Garanta que o usuário tenha permissões de Leitura, Escrita, Criação, Exclusão, etc.
- Clique em Salvar.
Essa etapa é essencial! Sem permissões, o banco está fechado para o WordPress.
Passo 4: Limpe o cache (se necessário)
Às vezes, o erro persiste por causa de cache. Se você usou um plugin de cache (como WP Super Cache ou W3 Total Cache), vá até o plugin e limpe o cache.
Se não souber como, simplesmente vá ao seu site, faça login no WordPress (se conseguir), e verifique se há uma opção de "Limpar Cache" no menu do plugin.
Passo 5: Revisite o arquivo wp-config.php
Após corrigir os dados no cPanel, volte ao arquivo wp-config.php e verifique se todos os dados estão exatamente como os do banco de dados.
Se estiver tudo certo, salve o arquivo e recarregue seu site.
Passo 6: Erro persistindo? Reinicie o servidor de banco de dados (só se necessário)
Em raras ocasiões, o banco de dados pode ter parado por algum motivo. Isso é raro, mas pode acontecer.
Se nada funcionar, entre em contato com nosso suporte. Nós podemos reiniciar o servidor de banco de dados para você — sem precisar se preocupar com nada.
Dica final do Sensei:
Se você não tem certeza sobre os dados, nunca tente adivinhar. Sempre confira no cPanel. É mais seguro e rápido.
Se precisar de ajuda, estamos aqui. Basta nos chamar — com um sorriso, um café e um bom coração. ☕❤️
Seu site vai voltar a funcionar em breve. Acredite! 🌟