Como corrigir a mensagem "Error establishing a database connection" no WordPress

Como corrigir o "Error establishing a database connection" no WordPress

Oi! Eu sou a Sensei da GeHost 🌱 e vou te guiar, com calma e sem termos complicados, para resolver essa mensagem que assusta bastante quando aparece: "Error establishing a database connection" (ou, em português, "Erro ao estabelecer conexão com o banco de dados").

Antes de mais nada: respira. Esse erro é um dos mais comuns no WordPress e, na grande maioria das vezes, tem solução simples. Ele acontece quando o seu site não consegue "conversar" com o banco de dados onde ficam guardados seus textos, posts, produtos e configurações.

💡 Dica da Sensei: antes de mexer em qualquer arquivo, faça um backup. Assim, se algo der errado, você sempre pode voltar atrás com tranquilidade.

Por que esse erro acontece?

As causas mais comuns são:

• As informações de acesso ao banco de dados no arquivo wp-config.php estão erradas ou desatualizadas.
• O banco de dados foi corrompido (às vezes acontece após uma queda de energia, atualização mal concluída ou plugin com problema).
• O nome de usuário do banco perdeu a permissão de acesso ao banco correspondente.
• O site está recebendo mais acessos do que o seu plano de hospedagem suporta no momento.

Vamos verificar cada possibilidade, passo a passo. 🙂

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

Esse arquivo é o "crachá de identificação" do seu site perante o banco de dados. Se algum dado nele estiver errado, a conexão falha.

1. Acesse o cPanel da sua hospedagem (o link e os dados de acesso ficam no seu painel do cliente, em painel.gehost.com.br).

2. Dentro do cPanel, abra o Gerenciador de Arquivos.
3. Entre na pasta public_html (ou na subpasta onde seu WordPress está instalado).
4. Localize o arquivo wp-config.php, clique com o botão direito e escolha Editar.

5. Procure por estas linhas (os valores depois do sinal de igual são os que importam):

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

Guarde esses valores de lado — vamos compará-los com o que está cadastrado de verdade no próximo passo.

Passo 2: Confira se o banco e o usuário existem no cPanel

1. Ainda no cPanel, procure a seção Bancos de Dados MySQL.
2. Veja se o nome do banco listado ali é exatamente igual ao que está no wp-config.php (atenção: geralmente tem um prefixo antes do nome, algo como "usuario_nomedobanco").
3. Confira também se o usuário existe e se ele está vinculado a esse banco, com todos os privilégios marcados.

💡 Dica da Sensei: se você não tem certeza da senha, é mais seguro redefinir uma senha nova para o usuário do banco (na própria tela de Bancos de Dados MySQL) e depois atualizar essa mesma senha no wp-config.php. Assim você elimina qualquer dúvida.

Se o banco ou o usuário sumiram

Se você não encontrar o banco ou o usuário esperado, não altere nada por conta própria além de conferir — nesse caso é melhor chamar o nosso suporte para investigarmos juntos com calma, sem risco de perda de dados.

Passo 3: Verifique se o banco de dados está corrompido

Às vezes o "endereço" está certo, mas o banco em si teve algum problema interno. O WordPress tem uma ferramenta própria para tentar reparar isso:

1. Abra novamente o arquivo wp-config.php pelo Gerenciador de Arquivos.
2. Adicione esta linha, logo antes de onde está escrito "That's all, stop editing! Happy publishing.":

define( 'WP_ALLOW_REPAIR', true );

3. Salve o arquivo e acesse, no navegador: seudominio.com.br/wp-admin/maint/repair.php
4. Clique em "Reparar banco de dados" (ou "Reparar e otimizar banco de dados").
5. Depois que terminar, volte ao wp-config.php e apague a linha que você adicionou — ela não pode ficar ativa permanentemente, pois qualquer visitante poderia acessar essa página.

⚠️ Importante: não esqueça o passo 5! Deixar essa linha ativa expõe uma ferramenta de manutenção do seu site para qualquer pessoa.

Passo 4: O erro aparece só pra você (como admin) ou pra todo mundo?

Se ao entrar como administrador aparece uma mensagem um pouco diferente, do tipo "One or more database tables are unavailable", isso reforça que o problema é mesmo no banco — e o Passo 3 é o caminho certo.

Se o erro aparece só em horários de muito acesso ao site (por exemplo, durante uma promoção ou pico de visitas), pode ser que o consumo do seu plano esteja no limite nesse momento. Nesse caso, dá uma olhada no seu plano contratado no painel.gehost.com.br — se notar que o site cresceu bastante, nossa equipe pode te ajudar a avaliar se vale a pena evoluir de plano.

Passo 5: Ainda não resolveu?

Sem problema — alguns casos realmente precisam de um olhar mais técnico direto no servidor. Fale com a gente pelo painel do cliente e conte:

• Quando o erro começou a aparecer;
• Se você fez alguma alteração recente (instalou plugin, tema, atualização);
• Os passos que você já tentou daqui.

Isso ajuda nossa equipe a te atender mais rápido. 💚

🌱 Mensagem da Sensei: erros de banco de dados parecem assustadores, mas quase sempre são só uma credencial desatualizada ou uma tabela pedindo um "carinho". Você não precisa ser expert em tecnologia para resolver — e, se travar em qualquer passo, estamos aqui pra continuar com você.