Se o seu site WordPress deu aquele erro clássico «Erro ao estabelecer uma conexão com o banco de dados», você não está sozinho. Esse é um dos problemas mais comuns e mais urgentes que existem, porque derruba o site inteiro — home, painel, posts, tudo. E o pior: geralmente aparece na hora errada.
O WordPress é só uma camada de PHP que conversa com um banco MySQL ou MariaDB. Quando essa conversa falha, o CMS não carrega nada. Não tem mágica: o erro de conexão ao banco de dados no WordPress acontece por um punhado de motivos concretos, e quase todos têm solução em minutos.
As causas reais do erro de conexão ao banco de dados no WordPress
Depois de anos lidando com isso em suporte, posso dizer que as causas se resumem a cinco. Não perca tempo procurando outras.
- O servidor MySQL caiu ou está sobrecarregado.
- As credenciais no wp-config.php estão erradas ou foram alteradas.
- O usuário do banco perdeu permissões ou a senha foi trocada no painel da hospedagem.
- O banco corrompeu ou alguma tabela foi deletada sem querer.
- O hostname mudou (clássico em migração de servidor esquecendo o DB_HOST).
Se você já viu o erro de conexão com o banco de dados no WordPress mais de uma vez, provavelmente foi por um desses cinco. E sim, hospedagem compartilhada barata é campeã em provocar o item 1.
Checklist para resolver o erro de banco de dados do WordPress
Vá por ordem de impacto. Comece pelo mais simples, porque a maioria dos casos morre aí.
1. Confirme se o banco de dados está de pé
Entre no cPanel, Plesk ou no painel da sua hospedagem e veja se o MySQL está ativo. Se tiver SSH, rode systemctl status mariadb ou service mysql status. Se estiver parado, reinicie. Se não voltar, é problema do provedor — abra ticket sem rodeios.
Detalhe que quase ninguém fala: hospedagens baratas limitam conexões simultâneas. Em pico de tráfego, o MySQL recusa novas conexões e o erro de conexão ao banco de dados no WordPress aparece para todos ao mesmo tempo. A solução real aí não é mexer em arquivo, é trocar de plano ou ativar cache agressivo.
2. Revise o wp-config.php sem medo
Esse arquivo é o cérebro da conexão. Abra por FTP ou pelo gerenciador de arquivos e confira quatro linhas com atenção:
- DB_NAME — o nome exato do banco, com o prefixo que a hospedagem impõe.
- DB_USER — o usuário, também com prefixo.
- DB_PASSWORD — cuidado com aspas e caracteres especiais.
- DB_HOST — quase sempre «localhost», mas em alguns servidores é um IP ou algo como mysql.hostinger.com.
Um caractere errado aqui derruba o site inteiro. Já vi gente perder três horas de suporte por causa de um espaço invisível colado no DB_PASSWORD.
3. Teste a conexão manualmente com phpMyAdmin
Abra o phpMyAdmin pela hospedagem e tente logar com o mesmo usuário e senha do wp-config.php. Se funcionar aí, o problema não é credencial — é permissão de host ou configuração de PHP. Se não funcionar, você achou a raiz do erro ao conectar WordPress com o banco de dados: senha ou usuário estão errados. Redefina a senha no painel e atualize o arquivo.
Pegadinha clássica: muitos servidores exigem que o usuário esteja autorizado para o host específico. Se você criou o usuário mas não atribuiu ao banco com ALL PRIVILEGES, a conexão falha mesmo com senha correta.
Quando o problema é corrupção no banco
Se as credenciais estão certas e o phpMyAdmin conecta, mas o site continua com o erro de conexão ao banco de dados no WordPress, pode ser corrupção em alguma tabela. Isso vem junto com atualização interrompida, plugin mal feito ou queda de energia no servidor.
Nesse cenário, rode um REPAIR TABLE no phpMyAdmin nas tabelas do site (comece por wp_options e wp_posts). Se você não tem backup recente, pare tudo e faça um dump agora antes de mexer em qualquer coisa.
Renomear o wp-config.php funciona?
Sim, funciona — mas como último recurso. Se você renomear o wp-config.php para algo como wp-config-old.php e acessar o site, o WordPress dispara o instalador e pede os dados de conexão de novo. Ele cria um arquivo limpo, com as credenciais corretas.
Só que tem um detalhe que quase ninguém menciona: isso não recupera o conteúdo se o banco estiver inacessível. Ele só reconstrói a ponte. Se os dados estiverem lá, tudo volta. Se não, você termina com uma instalação vazia e um banco órfão pelo caminho. Portanto, faça backup antes. Sempre.
Erros que eu vejo repetindo no suporte
Depois de anos mexendo com isso, dá para prever o comportamento. Aqui vão os tropeços mais comuns:
- Trocar a senha do banco no painel e esquecer de atualizar o wp-config.php.
- Migrar de hospedagem mantendo o DB_HOST antigo.
- Instalar plugin de «otimização de banco» que apaga tabelas sem aviso.
- Editar o wp-config.php com editor que insere BOM e quebra o PHP.
- Exceder o limite de conexões do plano compartilhado.
Nenhum desses é mistério. Todos têm correção objetiva. E todos podem ser prevenidos com dois hábitos simples: monitoramento de uptime e backup automático diário fora do servidor.
Como evitar que o erro de conexão ao banco de dados no WordPress volte
Não existe site 100% imune, mas dá para reduzir muito o risco de ver o erro de conexão do WordPress ao banco de dados de novo:
- Ative cache de página (WP Rocket, LiteSpeed Cache) para reduzir consultas ao banco.
- Use CDN. Menos hits no servidor, menos conexões MySQL abertas.
- Mantenha o PHP e o MySQL atualizados via hospedagem.
- Nunca guarde o wp-config.php com permissão 777.
- Tenha um backup que você consiga restaurar em menos de 15 minutos.
Se você faz isso, o erro ainda pode aparecer — mas você resolve em minutos, não em dias.
Uma última coisa que ninguém te conta
Às vezes o problema não está no seu site. Está no vizinho. Em hospedagem compartilhada, outro cliente pode estar consumindo toda a CPU e derrubando o MySQL para todos. Nesse caso, atualizar arquivo, senha ou plugin não resolve nada. Você precisa migrar para um ambiente isolado, com container próprio ou VPS.
Parece exagero, mas é a diferença entre ter um site que cai uma vez por mês e um site que simplesmente funciona. Trate o banco de dados como o coração do seu WordPress — porque é exatamente isso que ele é.