Como resolver o erro 'Sanduíche de erro de conexão com o banco de dados' no WordPress via SSH

O "Sanduíche do Erro de Conexão com o Banco de Dados" no WordPress: resolvendo via SSH

Olá! Aqui é a Sensei da GeHost 🥋. Se você chegou até aqui, provavelmente abriu seu site e viu uma tela branca com uma frase mais ou menos assim, "encaixada" entre duas linhas de mensagem: "Error establishing a database connection" (ou, em português, "Erro ao estabelecer conexão com o banco de dados"). Chamamos isso carinhosamente de "sanduíche do erro" porque a mensagem fica sozinha, cercada de espaço em branco, sem nenhum outro elemento do site.

Calma, respira. Esse erro é chato, mas é um dos mais comuns em WordPress e, na maioria das vezes, tem solução rápida. Vamos resolver juntos, passo a passo, usando o acesso SSH da sua hospedagem.

O que esse erro realmente significa?

O WordPress não é só os arquivos do seu site — ele guarda todo o conteúdo (posts, páginas, usuários, configurações) num banco de dados MySQL. Quando o WordPress tenta "conversar" com esse banco e não consegue, ele exibe esse erro. As causas mais comuns são:

• As credenciais do banco (usuário, senha ou nome do banco) estão erradas no arquivo wp-config.php;
• O banco de dados está corrompido ou com alguma tabela danificada;
• O usuário do banco perdeu a permissão de acesso àquele banco específico;
• Instabilidade momentânea no servidor de banco de dados.

💡 Dica da Sensei: antes de mexer em qualquer coisa, faça um backup. Você pode gerar um pelo cPanel > Backup, na sua área de hospedagem. Assim, se algo sair diferente do esperado, você volta pro ponto de partida com tranquilidade.

Passo 1 — Conecte-se via SSH

Se sua hospedagem já tem o acesso SSH liberado, conecte-se normalmente pelo terminal do seu computador (Terminal no Mac/Linux, ou PowerShell/PuTTY no Windows) usando o usuário e a porta que constam no seu painel do cliente, em painel.gehost.com.br. Se você ainda não tem certeza de como habilitar ou encontrar esses dados, chame o suporte antes de continuar.

Passo 2 — Confira o arquivo wp-config.php

Esse arquivo fica na raiz da instalação do WordPress (geralmente dentro de public_html) e é onde ficam guardadas as credenciais do banco. Com o SSH conectado, navegue até a pasta do site e abra o arquivo para leitura:

1. Entre na pasta do site: cd public_html (ajuste o caminho se o WordPress estiver em uma subpasta);
2. Visualize o conteúdo do arquivo com: cat wp-config.php;
3. Procure pelas linhas: DB_NAME, DB_USER, DB_PASSWORD e DB_HOST.

Anote esses quatro valores. Eles precisam bater exatamente com o que existe no seu cPanel.

Passo 3 — Compare com o cPanel > Bancos de Dados MySQL

Agora vá até o cPanel da sua hospedagem e acesse a seção Bancos de Dados MySQL. Verifique se:

• O nome do banco (DB_NAME) existe exatamente igual, com o prefixo da conta;
• O usuário (DB_USER) existe e está vinculado a esse banco na área "Usuários Atuais" — esse é o erro mais comum: o usuário existe, mas foi removido da lista de acesso ao banco;
• A senha (DB_PASSWORD) está correta — se tiver dúvida, é mais seguro redefinir a senha do usuário do banco ali mesmo no cPanel e depois atualizar o wp-config.php com a senha nova.

Se precisar corrigir algum valor no wp-config.php via SSH, você pode editar o arquivo com um editor de linha de comando, como nano wp-config.php. Faça a alteração, salve (no nano: Ctrl+O, depois Enter, e Ctrl+X para sair) e teste o site novamente.

⚠️ Atenção: normalmente o DB_HOST em hospedagem compartilhada é localhost. Se essa linha estiver diferente disso sem um motivo claro, é um bom ponto para revisar.

Passo 4 — Teste a conexão diretamente pelo terminal

Com SSH você consegue testar se as credenciais realmente funcionam, sem depender do WordPress. Use o comando abaixo, substituindo pelos dados que você anotou no Passo 2:

mysql -u SEU_USUARIO -p SEU_BANCO

O terminal vai pedir a senha. Digite-a (ela não aparece na tela, é assim mesmo) e pressione Enter.

• Se conectar e aparecer o prompt mysql>, as credenciais estão corretas — o problema pode estar em outro lugar (banco corrompido, por exemplo, veja o Passo 5).
• Se aparecer um erro de acesso negado, o problema é mesmo usuário/senha/permissão — volte ao Passo 3.

Para sair do prompt do MySQL, digite exit e pressione Enter.

Passo 5 — Suspeita de banco corrompido? Repare as tabelas

Se as credenciais estão corretas e o erro continua, uma tabela do banco pode estar corrompida. Se sua hospedagem tiver o WP-CLI disponível, o comando mais simples é:

wp db repair

Rode esse comando dentro da pasta do WordPress. Ele varre e conserta as tabelas automaticamente. Se o WP-CLI não estiver disponível na sua hospedagem, fale com o suporte para orientarmos o reparo via cPanel.

Passo 6 — Ainda sem solução?

Se você seguiu todos os passos acima e o sanduíche do erro insiste em aparecer, pode ser uma instabilidade momentânea do servidor de banco de dados ou algo que precisa de um olhar mais técnico do nosso time. Não se preocupe — é exatamente pra isso que estamos aqui.

📩 Dica final da Sensei: ao abrir um chamado, já mande print do erro, o horário aproximado em que começou e, se puder, o resultado do teste do Passo 4. Isso agiliza (e muito!) o diagnóstico da nossa equipe.

Você conseguiu chegar até aqui e já entende bem mais sobre o que acontece por trás do seu site. Isso já é um baita progresso! 🌱