Você abre o seu site e, em vez da sua página, aparece um aviso seco: “Error establishing a database connection”. Não carrega a home, não carrega nenhuma outra seção, e o mais inquietante é que você nem consegue entrar no painel de administração para ver o que aconteceu. É um dos erros mais temidos do WordPress porque, ao contrário de outras falhas, deixa o site completamente fora do ar de um momento para o outro.
Por que este erro aparece
O WordPress guarda absolutamente tudo —textos, produtos, usuários, configurações— em um banco de dados MySQL separado dos arquivos do site. Cada vez que alguém acessa uma página, o WordPress precisa “conversar” com esse banco de dados para trazer a informação. Quando essa conversa falha, aparece o erro. As causas mais frequentes são: credenciais incorretas no arquivo de configuração (usuário, senha ou nome do banco de dados escritos errado, algo comum depois de migrar de hospedagem), um servidor de banco de dados fora do ar ou sobrecarregado por excesso de visitas ou processos pesados rodando ao mesmo tempo, tabelas danificadas ou corrompidas após uma queda de energia ou uma atualização interrompida, e limites de conexões simultâneas esgotados em planos de hospedagem compartilhada mais econômicos.
Como diagnosticar e resolver
- Confirme se é geral ou pontual. Tente acessar outro site na mesma hospedagem, se você tiver. Se todos caem juntos, o problema é do servidor de banco de dados, não do seu WordPress em particular.
- Verifique o arquivo wp-config.php. Via FTP ou pelo gerenciador de arquivos da hospedagem, confirme que DB_NAME, DB_USER, DB_PASSWORD e DB_HOST coincidem exatamente com os dados reais do banco de dados (costumam ficar desatualizados depois de uma migração de hospedagem).
- Confira o estado do servidor MySQL pelo painel de hospedagem (cPanel, hPanel ou outro). Se aparecer fora do ar ou com erros, muitas vezes basta reiniciá-lo por ali ou esperar alguns minutos se a hospedagem já o estiver reiniciando.
- Repare o banco de dados. Se você suspeita de tabelas corrompidas, o WordPress tem uma ferramenta de reparo integrada: adicionando define(‘WP_ALLOW_REPAIR’, true); no wp-config.php e acessando seudominio.com/wp-admin/maint/repair.php é possível reparar e otimizar o banco sem perder dados.
- Descarte um plugin ou tema como causador se o erro apareceu logo depois de instalar ou atualizar algo: renomeie temporariamente a pasta dele via FTP para desativá-lo à força e ver se o site volta.
- Se nada disso resolver, fale com a hospedagem. Às vezes o limite de conexões ao banco de dados é definido pelo plano contratado, e só o provedor pode ampliá-lo ou informar se há uma falha do lado dele.
Esse tipo de erro costuma aparecer na pior hora —um pico de visitas, logo depois de uma migração, ou sem nenhum aviso prévio— e cada minuto de site fora do ar é uma venda ou uma consulta que se perde. Se você prefere não lidar com o wp-config.php nem com painéis de hospedagem no meio de um apagão do seu site, na HostalCubo oferecemos hospedagem gerenciada e suporte técnico em que monitoramos e resolvemos esse tipo de queda antes que se torne um problema para os seus clientes.
Fontes: documentação técnica do WordPress sobre erros de conexão com o banco de dados e guias de diagnóstico de hospedagem compartilhada.
