Como corrigir o erro 'Error establishing a database connection'

Como corrigir o erro "Error establishing a database connection" na GeHost

Olá, querido(a) cliente! 😊

Se você está vendo a mensagem "Error establishing a database connection" ao acessar seu site, não se preocupe — isso é um erro comum, mas geralmente fácil de resolver. Vamos juntos, passo a passo, como consertar isso com calma e certeza. Você não está sozinho nessa jornada. Sou a Sensei da GeHost, e estou aqui para te ajudar com um toque de cuidado e clareza.

Esse erro geralmente acontece quando o site não consegue se conectar ao banco de dados MySQL. Pode ser por causa de dados incorretos no arquivo de configuração, banco de dados desativado, ou usuário sem permissão. Vamos verificar tudo com carinho.

Passo 1: Verifique os dados do banco de dados no arquivo de configuração

O arquivo principal que contém as informações do banco de dados é normalmente o wp-config.php (se você usa WordPress) ou um arquivo semelhante, dependendo do sistema que usa.

Para acessá-lo:

1. Entre no Painel do Cliente da GeHost.
2. Na seção de Hospedagem, clique em Gerenciar (ou o nome do seu site).
3. Abra o Gerenciador de Arquivos (File Manager).
4. Navegue até a pasta principal do seu site — geralmente public_html ou uma subpasta como www.
5. Localize o arquivo wp-config.php (ou o arquivo de configuração do seu sistema).

Abra o arquivo com o editor do painel e verifique estas linhas:

• DB_NAME — o nome do banco de dados.
• DB_USER — o nome do usuário do banco.
• DB_PASSWORD — a senha do usuário.
• DB_HOST — geralmente é localhost.

Se algum desses dados estiver errado, o site não conseguirá se conectar ao banco.

Passo 2: Confira se o banco de dados e o usuário existem

Volte ao painel do cPanel e acesse a ferramenta Bancos de Dados MySQL.

Na lista, você verá:

• O nome do banco de dados (ex: meusite_db).
• O nome do usuário (ex: meusite_user).

Confira se:

• O banco de dados foi criado.
• O usuário foi criado e está associado ao banco.
• O usuário tem permissão para acessar o banco.

Se o banco ou o usuário estiverem faltando, você pode criá-los aqui mesmo.

Passo 3: Verifique as permissões do usuário

Depois de criar o usuário, é essencial que ele tenha permissões para acessar o banco.

Na mesma tela de Bancos de Dados MySQL, clique em Gerenciar Usuários ou em Editar Permissões (o botão pode variar, mas geralmente está ao lado do nome do usuário).

Selecione o banco de dados e garanta que o usuário tenha permissão de Leitura e Escrita (ou "Full Access").

Dica da Sensei: Sem permissão, mesmo que o banco exista, o site não consegue se conectar. É como ter uma chave que não abre a porta — o erro aparece por causa disso.

Passo 4: Atualize o arquivo de configuração

Se você descobriu que os dados estão errados (nome do banco, usuário ou senha), edite o arquivo wp-config.php novamente com os dados corretos.

Depois de salvar, espere alguns segundos e recarregue o site.

Se o erro persistir, pode ser que o banco de dados esteja corrompido ou que o sistema tenha sido mal configurado durante a instalação.

Passo 5: Reinstale o sistema (se necessário)

Se tudo estiver certo, mas o erro ainda aparecer, pode ser que o banco de dados esteja vazio ou corrompido.

Se você usa WordPress, por exemplo, você pode reinstalar o sistema via Softaculous (em Instaladores de Aplicativos no cPanel).

Isso vai recriar o banco de dados e o usuário com as configurações corretas.

Quer ajuda extra?

Se você seguiu todos os passos e ainda assim o erro persiste, não se sinta sozinho. A GeHost está aqui para te ajudar.

Entre em contato com o Suporte Técnico pelo painel do cliente. Eles vão investigar com cuidado, sem pressa, e te ajudar com empatia.

Se precisar, você pode enviar:

• Uma cópia do arquivo wp-config.php (sem a senha).
• Uma mensagem de erro completa.
• O nome do domínio e do site.

Assim, nosso time pode te ajudar com precisão.

Resumo em 3 passos simples

1. Verifique os dados do banco no arquivo de configuração.
2. Confirme que o banco e o usuário existem no cPanel.
3. Garanta que o usuário tem permissão de acesso.

Se tudo estiver certo, seu site volta a funcionar com alegria. 🌟

Se precisar de mais ajuda, lembre-se: a GeHost está aqui com você. E se você quiser, pode me chamar de Sensei — porque ensinar é o meu propósito.

Com carinho,
A Sensei da GeHost