Como corrigir o erro 'Erro ao estabelecer conexão com o banco de dados' no WordPress

🩺 "Erro ao estabelecer conexão com o banco de dados" — vamos consertar juntos!

Oi! Aqui é a Sensei da GeHost 🥋 Se o seu site WordPress apareceu com a telinha branca escrito "Erro ao estabelecer conexão com o banco de dados", respira fundo: isso é um dos problemas mais comuns do WordPress e, na maioria das vezes, tem conserto rápido. Vou te guiar passo a passo, sem enrolação e sem termo técnico complicado.

💡 Por que isso acontece? O WordPress guarda todo o conteúdo do seu site (textos, produtos, configurações) num banco de dados. Esse erro aparece quando o site não consegue "conversar" com esse banco — geralmente por causa de uma senha desatualizada no arquivo de configuração, um banco corrompido, ou o site recebendo mais visitas do que o normal.

🔎 Passo 1 — Confirme se é só com você

Antes de mexer em qualquer coisa, veja se o erro aparece pra todo mundo ou só na sua tela:

• Tente abrir o site pelo celular usando os dados móveis (sem wi-fi).
• Peça pra alguém de outra casa/rede testar.

Se só você vê o erro, pode ser cache do navegador — limpe o cache ou teste numa aba anônima. Se aparece pra todo mundo, siga para o Passo 2. 👇

🔑 Passo 2 — Confira as credenciais do banco no wp-config.php

Esse é o motivo mais comum: o arquivo wp-config.php guarda o nome do banco, o usuário e a senha que o WordPress usa pra se conectar. Se algo mudou aí (ou foi digitado errado em algum momento), o site perde a conexão.

1. Entre no seu cPanel (o link e os dados de acesso ficam no seu painel do cliente, em painel.gehost.com.br).
2. Abra o Gerenciador de Arquivos e localize a pasta do seu site (geralmente public_html).
3. Clique com o botão direito no arquivo wp-config.php e escolha "Editar".
4. Confira estas quatro linhas:
   • DB_NAME — nome do banco de dados
   • DB_USER — usuário do banco
   • DB_PASSWORD — senha do banco
   • DB_HOST — geralmente localhost

🗄️ Passo 3 — Confira 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 cPanel:

1. No cPanel, procure a ferramenta Bancos de Dados MySQL.
2. Veja se o nome do banco listado ali é exatamente igual ao que está em DB_NAME.
3. Role até "Usuários Atuais" e confira se o usuário de DB_USER está vinculado a esse banco (com todos os privilégios marcados).

Se você esqueceu a senha do banco, dá pra redefinir ali mesmo na tela de "Usuários Atuais" — só lembre de atualizar a senha nova também no wp-config.php (a senha precisa ser igual nos dois lugares, senão a conexão continua quebrada).

🛠️ Passo 4 — Tente o modo de reparo do próprio WordPress

O WordPress tem um modinho de reparo automático embutido. Pra ativar:

1. Volte ao Gerenciador de Arquivos e edite de novo o wp-config.php.
2. Adicione esta linha logo acima de onde está escrito /* That's all, stop editing! */:
   define('WP_ALLOW_REPAIR', true);
3. Salve o arquivo e acesse pelo navegador: seudominio.com/wp-admin/maint/repair.php
4. Clique em "Reparar banco de dados" (ou "Reparar e Otimizar banco de dados").
5. Importante: depois de terminar, volte no wp-config.php e remova a linha que você adicionou — deixá-la ativa expõe essa página de reparo pra qualquer visitante.

📦 Passo 5 — Se nada resolver, é hora de um backup + uma mãozinha nossa

Se você já conferiu tudo acima e o erro continua, o banco pode estar corrompido de verdade (às vezes por causa de um plugin com problema, uma tabela danificada, ou pico de acessos). Nesse ponto:

• Confira se você tem um backup recente (a ferramenta "Backup" do cPanel te ajuda a baixar ou restaurar um backup completo/parcial).
• Abra um chamado pro nosso suporte contando exatamente quando o erro começou e o que você já tentou — isso agiliza muito o diagnóstico.

✅ Resumo rápido

1. Confirme se o erro é geral ou só na sua tela.
2. Confira as credenciais em wp-config.php.
3. Compare com o banco/usuário reais em "Bancos de Dados MySQL" no cPanel.
4. Tente o modo de reparo do WordPress.
5. Sem sucesso? Backup + chamado pro suporte.

🤝 Se ficar travado em qualquer um desses passos, pode chamar a gente — é bem mais rápido resolver com um chamado no seu painel (painel.gehost.com.br) do que ficar tentando sozinho. A Sensei está aqui torcendo por você! 🥋