Como resolver o erro "Erro ao estabelecer conexão com o banco de dados" no WordPress

Erro ao Estabelecer Conexão com o Banco de Dados: o que é e por que acontece?

Oi! Eu sou a Sensei da GeHost, e vou te ajudar a resolver esse susto 😊 A mensagem "Erro ao estabelecer conexão com o banco de dados" é um dos erros mais comuns do WordPress, e a boa notícia é que, na grande maioria das vezes, ele tem solução simples e rápida.

Esse erro acontece quando o WordPress tenta "conversar" com o banco de dados (onde ficam salvos seus posts, páginas, usuários e configurações) e essa conversa falha. Vamos entender os motivos mais comuns e resolver juntos, passo a passo.

Dica da Sensei: antes de qualquer coisa, respire fundo. Esse erro quase nunca significa que seu conteúdo foi perdido — na maioria dos casos é só uma informação de acesso desatualizada ou um arquivo corrompido.

Principais causas desse erro

• Dados de acesso ao banco (usuário, senha ou nome do banco) incorretos no arquivo wp-config.php
• Usuário do banco sem permissão vinculada ao banco de dados
• Tabelas do banco corrompidas
• Plugin ou tema com conflito
• Instabilidade momentânea — vale tentar novamente em alguns minutos

Passo a passo para resolver

1. Confira as credenciais no arquivo wp-config.php

O arquivo wp-config.php guarda as "chaves" que conectam o WordPress ao banco de dados. Se alguma delas estiver errada, o erro aparece na hora.

1. Acesse o cPanel da sua hospedagem.
2. Abra o Gerenciador de Arquivos e entre na pasta public_html (ou na subpasta do seu site).
3. Clique com o botão direito no arquivo wp-config.php e escolha Editar.
4. Procure estas linhas:

define( 'DB_NAME', 'nome_do_banco' );
define( 'DB_USER', 'usuario_do_banco' );
define( 'DB_PASSWORD', 'senha_do_banco' );
define( 'DB_HOST', 'localhost' );

Confirme se o nome do banco, o usuário e a senha realmente batem com o que está cadastrado no seu banco de dados MySQL. Em praticamente todos os casos na GeHost, o DB_HOST correto é localhost.

2. Verifique o banco de dados e o usuário no cPanel

Se você não tem certeza dos dados corretos (ou suspeita que a senha mudou), o cPanel te mostra tudo isso na tela de Bancos de Dados MySQL.

1. No cPanel, acesse Bancos de Dados MySQL.
2. Confirme se o banco listado no wp-config.php aparece na lista de bancos existentes.
3. Na seção de usuários, confira se o usuário do banco está vinculado a esse banco (com todos os privilégios marcados).
4. Se tiver dúvida sobre a senha, você pode redefini-la ali mesmo e depois atualizar essa mesma senha no wp-config.php.

Dica da Sensei: se você redefinir a senha do usuário do banco, não esqueça de atualizar o wp-config.php também — os dois precisam estar sempre iguais!

3. Verifique se as tabelas do banco não estão corrompidas

Às vezes o problema não é de acesso, e sim de uma tabela danificada dentro do próprio banco. O WordPress tem um modo de reparo automático para isso.

1. No arquivo wp-config.php, adicione esta linha logo acima de onde está escrito /* Isso é tudo, pode parar de editar! */:

define( 'WP_ALLOW_REPAIR', true );

2. Salve o arquivo e acesse, pelo navegador, o endereço: seusite.com.br/wp-admin/maint/repair.php
3. Clique em "Reparar banco de dados" (ou "Reparar e otimizar").
4. Depois que terminar, remova a linha que você adicionou no wp-config.php — essa página fica exposta enquanto a linha estiver ativa, e é importante fechá-la depois do uso.

4. Desative plugins e tema (se o erro começou depois de uma atualização)

Se o erro apareceu logo depois de instalar ou atualizar um plugin, pode ser um conflito. Você pode desativar tudo temporariamente direto pelo Gerenciador de Arquivos, sem precisar entrar no painel do WordPress:

1. No Gerenciador de Arquivos, vá até public_html/wp-content/plugins.
2. Renomeie a pasta plugins para algo como plugins-teste.
3. Teste o site novamente. Se voltar ao normal, o problema era algum plugin — você pode renomear a pasta de volta e desativar os plugins um a um pelo painel para descobrir o culpado.

5. Ainda não resolveu?

Sem problemas — isso acontece, e é para isso que estamos aqui! Se você seguiu os passos acima e o erro continua, entre em contato com o nosso suporte. Leve em mãos (ou por print) as informações que você já verificou, isso agiliza bastante o atendimento.

Dica da Sensei: você também pode acompanhar chamados e conferir detalhes do seu plano de hospedagem a qualquer momento pelo painel.gehost.com.br.

Prontinho! Na maioria dos casos, o erro se resolve já no primeiro ou segundo passo. Estamos torcendo pelo seu site! 💚