Como resolver o erro "Error establishing a database connection" no WordPress
Oi, tudo bem? Aqui é a Sensei da GeHost 🥋 Se você entrou no seu site e viu essa telona branca com a frase "Error establishing a database connection", respira fundo: não é o fim do mundo. Esse é um dos erros mais comuns do WordPress e, na grande maioria das vezes, tem solução rápida. Vem comigo que eu te explico o que é e como resolver, passo a passo.
O que significa esse erro, afinal?
O WordPress guarda todo o conteúdo do seu site (textos, produtos, configurações) num banco de dados. Quando você acessa seu site, o WordPress "liga" pra esse banco pra buscar as informações. Esse erro aparece quando essa ligação não completa — ou seja, o WordPress não conseguiu conversar com o banco de dados.
Isso geralmente acontece por causa de: credenciais (usuário/senha) desatualizadas no arquivo de configuração, um banco de dados com problema, ou uma instabilidade momentânea. Vamos verificar cada uma dessas possibilidades.
Passo 1 — Confirme se é só com você (ou é geral)
Antes de mexer em qualquer coisa, tente acessar o site de outro dispositivo ou rede (dados móveis, por exemplo). Às vezes é só uma instabilidade rápida que já se resolve sozinha em poucos minutos.
Passo 2 — Confira as credenciais do banco no arquivo wp-config.php
O arquivo wp-config.php é o "crachá" que o WordPress usa pra se identificar no banco de dados. Se algum dado ali estiver errado (nome do banco, usuário, senha), a conexão falha. Veja como checar:
- Acesse o cPanel da sua hospedagem (o link e os dados de acesso ficam disponíveis no seu painel.gehost.com.br).
- Abra o Gerenciador de Arquivos e navegue até a pasta do seu site (geralmente
public_html). - Localize o arquivo
wp-config.php, clique com o botão direito e escolha Editar. - Procure as linhas com
DB_NAME,DB_USER,DB_PASSWORDeDB_HOST.
Passo 3 — Confirme se o banco e o usuário realmente existem
Agora vamos conferir se o que está escrito no wp-config.php bate com o que existe de verdade no seu painel:
- No cPanel, acesse Bancos de Dados MySQL.
- Verifique se o nome do banco listado ali é exatamente igual ao valor de
DB_NAMEnowp-config.php. - Confira também se o usuário do banco (em
DB_USER) está associado a esse banco na seção de usuários. - Se você não tiver certeza da senha, é possível redefinir a senha do usuário do banco ali mesmo — só lembre de atualizar essa nova senha no
DB_USER/DB_PASSWORDdowp-config.phptambém, senão o problema continua.
Passo 4 — Verifique se o banco de dados não está corrompido
Às vezes o banco fica com alguma tabela "machucada" (pode acontecer após uma queda de energia, atualização mal finalizada, etc.). Nesse caso, o WordPress costuma mostrar uma mensagem um pouco diferente, algo como "One or more database tables are unavailable" ou sugerindo um reparo. Se for esse o seu caso, o ideal é contar com a ajuda da nossa equipe de suporte pra fazer esse reparo com segurança, sem risco de perder dados.
Passo 5 — Se nada disso resolver, chame a gente 💬
Se você seguiu os passos acima e o site continua com o erro, não se preocupe — pode ser algo que precisa de um olhar mais técnico (como o servidor de banco de dados temporariamente sobrecarregado, ou um plugin/tema causando conflito). Abra um chamado no seu painel em painel.gehost.com.br contando o que você já tentou, que a nossa equipe entra em ação pra te ajudar.
Dica da Sensei: sempre que for editar o wp-config.php, faça uma cópia do arquivo original antes (basta baixar uma cópia pelo Gerenciador de Arquivos). Assim, se algo der errado, você consegue voltar pro estado anterior rapidinho.
Espero ter ajudado! Qualquer dúvida, é só chamar a gente por aqui. 🙏
