As Verdadeiras Razões Pelas Quais a Conexão do Seu Banco de Dados WordPress Falha (+ Como Corrigir)

Eu ainda me lembro do pânico que se instalou quando vi aquelas cinco palavras: “Erro ao estabelecer uma conexão com o banco de dados”.

Um minuto meu site WordPress estava funcionando perfeitamente, no outro — nada além de uma tela em branco com esta mensagem enigmática.

A parte mais frustrante foi perceber quantas coisas diferentes poderiam causar a mesma mensagem de erro.

Foi meu provedor de hospedagem? Fiz alguma alteração que quebrou algo? Fui atacado?

Se você está enfrentando este erro agora, respire fundo. Você está prestes a aprender exatamente o que causa esse problema comum do WordPress, como diagnosticá-lo corretamente da primeira vez e, o mais importante, como corrigi-lo rapidamente e evitar que aconteça novamente!

Aqui estão os principais pontos:

• O Erro ao Estabelecer uma Conexão com o Banco de Dados significa que o WordPress não consegue se comunicar com seu banco de dados; seu conteúdo ainda está seguro, apenas inacessível
• As causas mais comuns incluem credenciais incorretas do banco de dados, arquivos corrompidos do WordPress, sobrecarga do servidor ou problemas de hospedagem
• Sempre faça backup do seu site antes de tentar correções
• Restaurar um backup recente é frequentemente a solução mais rápida
• Comece a solucionar problemas com correções simples (verificando credenciais) antes de passar para soluções complexas (criando novos bancos de dados)
• Previna erros de conexão com o banco de dados através de backups regulares, atualizações e otimização do banco de dados

Sumário

O WordPress usa um banco de dados para registrar tudo em seu site. Isso inclui suas postagens, páginas, comentários, informações de usuário e configurações. Toda vez que alguém visita seu site, o WordPress precisa buscar essas informações no banco de dados para exibir seu conteúdo.

Quando o problema de conexão com o banco de dados acontece, o WordPress não consegue recuperar nenhuma dessas informações. Ele não consegue construir suas páginas da web ou mostrar seu conteúdo aos visitantes.

Em vez do seu site, os usuários veem uma tela branca completamente em branco ou uma mensagem de erro simples. O conteúdo está lá, mas você simplesmente não consegue acessá-lo.

Esse erro afeta todo o seu site. Você não conseguirá acessar seu painel de administração, publicar novo conteúdo ou fazer quaisquer alterações. Seu site está essencialmente offline até que a conexão com o banco de dados do WordPress seja restaurada.

Embora seja frustrante, lembre-se de que seu conteúdo não foi perdido. Ele ainda está armazenado com segurança no banco de dados. Precisamos apenas corrigir a conexão para que tudo volte a funcionar.

O que Causa o Erro de Conexão com o Banco de Dados no WordPress?

O erro de conexão com o banco de dados é um problema comum no WordPress e pode ocorrer por alguns motivos diferentes. Vamos detalhar os culpados mais comuns.

Credenciais incorretas de login no banco de dados são frequentemente as culpadas. O WordPress precisa do nome de usuário, senha e nome do banco de dados corretos para se conectar. Se algum desses detalhes estiver errado, você verá este erro.

Às vezes, seus arquivos do WordPress podem ficar corrompidos. Isso pode acontecer durante uma atualização mal sucedida ou se o seu site for invadido. Esses arquivos principais corrompidos podem quebrar sua conexão com o banco de dados.

Seu servidor de banco de dados pode estar com problemas. Se ele estiver sobrecarregado ou temporariamente inativo, o WordPress não conseguirá se conectar a ele.

Muitos sites utilizam planos de hospedagem compartilhada do WordPress. Se o seu site ficar popular repentinamente e exceder os limites do seu plano de hospedagem, ele poderá perder sua conexão com o banco de dados.

Incompatibilidades de versão do PHP também podem causar esse erro. Se o seu provedor de hospedagem atualizar o PHP, mas sua versão do WordPress não for compatível, isso pode levar a problemas de conexão.

Por último, malware ou tentativas de invasão podem interromper as funções normais do seu site, incluindo sua conexão com o banco de dados.

Como Corrigir o Erro ao Estabelecer uma Conexão com o Banco de Dados no WordPress

Agora que entendemos o que causa esse erro, vamos arregaçar as mangas e corrigi-lo. Passaremos por vários métodos, passo a passo. 

Aqui está um resumo rápido de como corrigir erros de conexão com o banco de dados:

• Restaurar um Backup: Use a recuperação de desastres (de plugins como Duplicator) para um rollback instantâneo
• Verificar Credenciais do Banco de Dados: Verifique nome de usuário, senha e nome do banco de dados em wp-config.php
• Verificar Informações do Host do Banco de Dados: Confirme o endereço correto do servidor
• Reparar seu Banco de Dados: Use a ferramenta de reparo integrada do WordPress para bancos de dados corrompidos
• Verificar Status do Servidor: Entre em contato com seu host para ver se o servidor do banco de dados está inativo ou sobrecarregado
• Corrigir Arquivos Corrompidos: Substitua os arquivos principais do WordPress por cópias novas
• Criar um Novo Banco de Dados: Comece do zero com um novo banco de dados e credenciais de usuário
• Atualizar URL do Site: Corrija incompatibilidades de URL após alterações de domínio ou protocolo
• Reiniciar o Servidor Web: Reinicie o servidor para limpar problemas temporários
• Contatar o Suporte: Obtenha ajuda profissional quando as correções "faça você mesmo" não funcionarem

Lembre-se, é sempre uma boa ideia fazer backup do seu site antes de fazer qualquer alteração!

1. Restaure um Backup

Às vezes, a solução mais simples é a melhor. Se você tiver um backup recente do seu site de antes do erro ocorrer, restaurá-lo pode resolver rapidamente o seu problema.

Backups regulares são como uma rede de segurança para o seu site. Eles podem economizar horas de solução de problemas e colocar seu site online rapidamente.

Com o Duplicator, você pode restaurar facilmente seu site após erros devastadores. Ele possui um recurso de recuperação de desastres que fornece um link de recuperação se algo der errado.

O erro ao estabelecer a conexão com o banco de dados geralmente bloqueará completamente o seu painel de administração. Mas você pode colar este link de recuperação em um navegador para reverter seu site.

Restaurar um backup funciona melhor quando o erro é devido a alterações recentes, como uma atualização de plugin ou um novo tema. É como apertar o botão de desfazer para todo o seu site.

Você também pode restaurar um backup diretamente do Duplicator Cloud quando seu wp-admin estiver inativo. Configure o conector de recuperação com as credenciais FTP do seu site.

Em seguida, agende backups automáticos para o Duplicator Cloud. Se você notar problemas em larga escala, encontre um backup recente na nuvem e restaure-o.

Para mais detalhes, leia meu guia sobre restaurar um site WordPress a partir de um backup.

Se você não tem um backup recente, não se preocupe. Temos muitos outros métodos para tentar. 

Que isso sirva de lembrete para configurar backups regulares para o seu site! Isso pode te poupar muitas dores de cabeça no futuro.

2. Verifique Suas Credenciais do Banco de Dados

Muitas vezes, o erro de conexão com o banco de dados é simplesmente devido a credenciais de login incorretas. Se você acabou de migrar para um novo provedor de hospedagem, seu site pode estar tentando se conectar ao banco de dados antigo em vez do novo. 

Vamos garantir que o WordPress tenha as informações corretas para acessar seu banco de dados.

Você precisará olhar o arquivo wp-config.php. Este arquivo contém os detalhes de login do seu banco de dados. 

Primeiro, conecte-se ao seu site usando FTP, cPanel ou o gerenciador de arquivos do seu provedor de hospedagem. Procure o arquivo wp-config.php no diretório principal do WordPress (public_html).

Abra este arquivo e procure por linhas que comecem com:

• DB_NAME
• DB_USER
• DB_PASSWORD
• DB_HOST

Essas linhas dizem ao WordPress como se conectar ao seu banco de dados. Certifique-se de que as informações aqui correspondam às suas credenciais reais do banco de dados do WordPress.

Se você não tem certeza do que deveriam ser, faça login no painel de controle da sua hospedagem. Procure por uma seção sobre bancos de dados ou MySQL. Você deve encontrar o nome do seu banco de dados, nome de usuário e senha lá.

Para usuários BlueHost, você pode clicar em Websites » Advanced. Na caixa Databases, clique em Manage.

Isso abrirá os detalhes do seu banco de dados no cPanel. 

Se você não tem certeza de qual é sua senha atual, role para baixo até Current Users e altere sua senha.

Se algum detalhe em wp-config.php não corresponder, atualize-o. Salve o arquivo wp-config.php e envie-o de volta para o seu servidor se estiver usando FTP.

Após a atualização, tente acessar seu site novamente. Se o erro desaparecer, ótimo! Você resolveu o problema.

3. Verifique as Informações do Host do Seu Banco de Dados

Às vezes, as informações do host do banco de dados no seu arquivo wp-config.php podem estar incorretas. Isso é especialmente comum se você mudou seu site para um novo host recentemente.

No seu arquivo wp-config.php, procure por uma linha que começa com DB_HOST

Para a maioria dos sites WordPress, isso é definido como ‘localhost’. Mas nem sempre é o caso.

Alguns provedores de hospedagem usam um endereço diferente para seus servidores de banco de dados. Você pode ver algo como ‘127.0.0.1’ ou um nome de servidor específico.

Se você não tem certeza do que isso deveria ser, entre em contato com seu provedor de hospedagem. Eles podem fornecer as informações corretas do host do banco de dados.

Assim que tiver as informações corretas, atualize a linha DB_HOST no seu arquivo wp-config.php. Salve as alterações e envie o arquivo de volta para o seu servidor.

Lembre-se, mesmo pequenos detalhes como uma letra faltando ou um espaço extra podem causar problemas de conexão. Verifique tudo novamente para ter certeza de que está exatamente certo.

4. Repare Seu Banco de Dados

Às vezes, o seu banco de dados pode estar corrompido. Felizmente, o WordPress tem uma ferramenta de reparo de banco de dados integrada. 

Primeiro, você precisará habilitar a ferramenta de reparo. Abra seu arquivo wp-config.php novamente. Adicione esta linha pouco antes de “That’s all, stop editing!”:

define('WP_ALLOW_REPAIR', true);

Agora, no seu navegador, acesse este endereço:

http://www.yoursite.com/wp-admin/maint/repair.php

Substitua “seusite.com” pelo nome real do seu domínio.

Você verá duas opções: Reparar Banco de Dados e Reparar e Otimizar Banco de Dados. Comece com a primeira opção. Se não funcionar, tente a segunda.

Clique no botão e deixe o WordPress fazer o trabalho. Este processo pode levar alguns minutos, dependendo do tamanho do seu banco de dados.

Assim que terminar, tente acessar seu site novamente. Lembre-se de remover a linha que você adicionou ao arquivo wp-config.php para desabilitar a ferramenta de reparo.

5. Verifique se o Servidor do Seu Banco de Dados Está Fora do Ar

Às vezes, o problema não é com o seu site WordPress. O seu próprio servidor de banco de dados pode estar com problemas.

Sinais de uma interrupção do servidor de banco de dados incluem:

• Múltiplos sites na mesma conta de hospedagem mostram erros semelhantes
• Você não consegue acessar seu painel de controle de hospedagem ou phpMyAdmin
• Seu host relata problemas no banco de dados

Se você suspeitar de um problema no servidor, entre em contato com seu provedor de hospedagem. Eles podem confirmar se há uma interrupção e dar uma estimativa de quando será corrigido.

Você também pode testar a conexão sozinho. Abra o phpMyAdmin e selecione o nome do seu banco de dados. Se conseguir, seu banco de dados ainda está online.

Agora, verifique se o seu usuário do banco de dados tem permissões suficientes. Crie um novo arquivo e nomeie-o testconnection.php. Cole o seguinte código nele:

<?php

$link = mysqli_connect('localhost', 'username', 'password');

if (!$link) {

die('Could not connect: ' . mysqli_error());

}

echo 'Connected successfully';

mysqli_close($link);

?>

Certifique-se de substituir o nome de usuário e a senha pelos detalhes corretos do seu banco de dados.

Envie o novo arquivo para o seu site. Se você conseguir acessá-lo em um navegador, seu usuário tem acesso suficiente. 

Enquanto espera o servidor voltar a ficar online, não há muito que você possa fazer para corrigir o erro. No entanto, você pode configurar uma página de manutenção temporária para informar aos seus visitantes o que está acontecendo.

Para fazer isso, eu recomendaria usar SeedProd. Este é um construtor de landing page popular que pode ajudá-lo a projetar uma página em modo de manutenção em segundos.

Interrupções no servidor geralmente são resolvidas rapidamente, mas nos lembram o quão importante é um provedor de hospedagem confiável. Se você enfrenta esses problemas com frequência, pode ser hora de considerar a troca de provedor.

Tenha em mente que este método não corrige ativamente nada. No entanto, identificar um problema no servidor pode economizar horas de solução de problemas desnecessários.

6. Corrija Arquivos Corrompidos do WordPress

Às vezes, seus arquivos principais do WordPress podem ficar corrompidos. Isso pode acontecer durante uma atualização, após uma tentativa de invasão ou devido a erros de transferência de arquivos. 

Arquivos corrompidos podem causar todo tipo de problema, incluindo erros de conexão com o banco de dados.

Para corrigir isso, você precisará substituir seus arquivos principais do WordPress por cópias novas. Não se preocupe, isso não afetará seu conteúdo ou configurações. 

No entanto, isso removerá qualquer código personalizado em seus arquivos .htaccess e wp-config.php. Certifique-se de fazer backup desses arquivos antes de continuar. 

Em seguida, baixe uma cópia nova do WordPress de wordpress.org.

Descompacte o arquivo no seu computador. Exclua a pasta wp-content e o arquivo wp-config-sample.php desta cópia nova.

Agora, use FTP para enviar o restante dos arquivos do WordPress para o seu servidor. Quando solicitado, escolha sobrescrever os arquivos existentes.

Este processo substitui todos os arquivos principais do WordPress por versões limpas. Seus temas, plugins e uploads estão seguros na pasta wp-content, que não tocamos.

Após o upload ser concluído, tente acessar seu site novamente. Se o seu site funcionar agora, os arquivos principais corrompidos provavelmente foram a causa.

Se você ainda estiver vendo o erro, seus arquivos de tema ou plugin também podem causar esse problema. Tente desativar todos os plugins e mudar para um tema padrão do WordPress para ver se isso resolve o problema.

Lembre-se, sempre mantenha sua instalação do WordPress, temas e plugins atualizados para minimizar o risco de corrupção de arquivos.

7. Crie um Novo Banco de Dados

Quando tudo mais falhar, começar do zero pode ser a melhor solução. Criar um novo banco de dados pode parecer assustador, mas é mais simples do que você imagina. 

Para criar um novo banco de dados, você normalmente usará o painel de controle da sua hospedagem. A maioria dos provedores oferece cPanel, o que torna esse processo muito fácil. Procure a opção MySQL Databases, que geralmente fica na seção Databases.

Uma vez lá, você verá um campo para inserir um novo nome de banco de dados. Escolha algo descritivo, mas evite espaços ou caracteres especiais.

Clique em Create Database, e pronto! Você tem um novo banco de dados.

Mas espere, ainda não terminamos. Seu novo banco de dados precisa de um usuário que possa acessá-lo. Na mesma área, você encontrará uma seção para adicionar um novo usuário.

Crie um novo usuário com uma senha forte. Lembre-se, esta é a chave para os dados do seu site, então torne-a difícil de adivinhar!

Agora, vincule seu novo usuário ao banco de dados que você acabou de criar. Geralmente, você encontrará uma opção para Add User to Database. Selecione seu novo usuário e banco de dados, e então conceda todos os privilégios.

Você criou um novo banco de dados e configurou um usuário. Mas como isso resolve nosso erro de conexão?

Aqui está a parte crucial: você precisa atualizar a configuração do WordPress para usar este novo banco de dados. 

Lembra do arquivo wp-config.php que mencionamos antes? É hora de editá-lo novamente.

Abra o wp-config.php e atualize os campos DB_NAME, DB_USER e DB_PASSWORD com as informações do seu novo banco de dados. Salve o arquivo e envie-o de volta para o seu servidor.

8. Atualize o URL do Site WordPress

Por que o URL do seu site pode precisar de atualização? Bem, talvez você tenha movido seu site para um novo domínio. Ou talvez você tenha mudado de HTTP para HTTPS. Essas alterações podem impedir que seu site se conecte ao banco de dados.

Para atualizar o URL do seu site, abra o phpMyAdmin e selecione seu banco de dados. Clique na aba SQL.

Cole a seguinte consulta MySQL:

UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'

Lembre-se de editar esta consulta para incluir seu novo URL. 

9. Reinicie o Servidor Web

Você já tentou desligar e ligar novamente? Essa velha sabedoria da TI se aplica a servidores web também.

Reiniciar seu servidor web pode muitas vezes resolver problemas misteriosos, incluindo erros de conexão com o banco de dados. É como dar um novo começo ao seu site.

Quando falamos sobre reiniciar seu servidor web, geralmente nos referimos a um processo que seu provedor de hospedagem pode fazer por você.

Se você tem um servidor dedicado, servidor local ou servidor virtual privado (VPS), pode ter uma opção de reinicialização no seu painel de hospedagem.

Alternativamente, você pode usar um cliente SSH para se conectar como usuário root e reiniciar seu servidor. Com uma opção como PuTTY, este comando reiniciará sistemas operacionais Linux:

reboot

10. Contate o Suporte

Suporte profissional pode ser uma salvação quando você está lidando com problemas técnicos teimosos. Mas a quem você deve contatar?

A equipe de suporte do seu provedor de hospedagem deve ser seu ponto de partida. Eles têm acesso direto ao seu servidor e muitas vezes podem identificar problemas que não são visíveis do seu lado. Muitos hosts oferecem suporte 24/7, então não hesite em entrar em contato, mesmo em horários incomuns.

Se o seu host não conseguir resolver o problema, ou se você suspeitar que é um problema específico do WordPress, os fóruns de suporte do WordPress são sua próxima parada. Esses fóruns estão repletos de membros úteis da comunidade e especialistas em WordPress que provavelmente já viram seu problema antes.

Para aqueles que executam sites críticos para os negócios, considere contratar um profissional de WordPress. Sua experiência pode ser inestimável, especialmente se você estiver perdendo receita devido a inatividade.

Lembre-se, há toda uma comunidade pronta para ajudar. Não lute sozinho com problemas técnicos. Às vezes, um novo olhar é tudo o que é preciso para encontrar a solução que você estava perdendo.

Como Corrigir Erros de Conexão com o Banco de Dados no Localhost

Se você está construindo seu site offline usando um ambiente de servidor local, você ainda pode encontrar esse erro frustrante. Configurações de localhost têm suas próprias peculiaridades, especialmente quando se trata de credenciais de banco de dados padrão.

Antes de fazer alterações no wp-config.php, faça backup do seu site. Mesmo em um ambiente local, é sempre melhor prevenir do que remediar! Você pode facilmente criar um backup local usando um plugin como o Duplicator.

Assim que seu backup estiver seguro, abra seu arquivo wp-config.php. Dependendo do software local que você está usando (XAMPP, MAMP ou LocalWP), aqui está um guia de como suas credenciais devem parecer:

• DB_NAME: Este é o nome exato do banco de dados que você criou no phpMyAdmin ou no painel do LocalWP.
• DB_USER: Para XAMPP, MAMP e geralmente LocalWP, o nome de usuário padrão é sempre root.
• DB_PASSWORD: É aqui que a maioria das pessoas se confunde!
  • XAMPP: Deixe a senha completamente em branco, como define( 'DB_PASSWORD', '' );
  • MAMP: A senha padrão é root.
  • LocalWP: O LocalWP geralmente usa root como padrão, mas você pode verificar isso conferindo a aba Database do seu site específico dentro do painel do LocalWP.
• DB_HOST: Na maioria dos casos, será apenas localhost. No entanto, se você estiver usando MAMP, pode ocasionalmente precisar adicionar o número da porta, tornando-o localhost:8889.

Simplesmente atualize esses valores para corresponder ao seu software específico, salve seu arquivo e atualize seu navegador. Seu site local deve voltar a funcionar.

Como Prevenir o Erro de Estabelecimento de Conexão com o Banco de Dados 

Vamos explorar algumas medidas proativas que você pode tomar para manter os erros de conexão com o banco de dados afastados.

Primeiro: backups, backups, backups. Não posso enfatizar isso o suficiente. Se algo der errado, você sempre poderá restaurar uma versão funcional do seu site. 

Procure fazer backup do seu site pelo menos semanalmente, ou diariamente para sites com alto tráfego. Com um plugin de backup como o Duplicator, você pode automatizar backups e proteger seus dados regularmente.

Em seguida, mantenha tudo atualizado. Isso inclui o core do WordPress, temas e plugins. As atualizações geralmente incluem patches de segurança e correções de bugs que podem prevenir problemas no banco de dados.

Se você estiver consistentemente atingindo os limites de recursos do seu servidor, pode ser hora de atualizar seu plano de hospedagem. Um servidor sobrecarregado pode levar a todos os tipos de problemas, incluindo erros de conexão com o banco de dados.

Cada plugin que você adiciona é um ponto potencial de falha. Use plugins bem mantidos e confiáveis, e não tenha medo de excluir aqueles que você não está usando ativamente.

Plugins como Wordfence ou Sucuri ajudam a proteger seu site contra problemas de segurança. Se houver algo errado com seu banco de dados, você saberá antes que seu site caia. 

Eu também recomendo otimizar seu banco de dados regularmente. Com o tempo, os bancos de dados podem ficar inchados com dados desnecessários. Use um plugin como o WP-Optimize para manter seu banco de dados enxuto e eficiente.

Tomar essas medidas pode parecer um trabalho extra agora. Mas acredite em mim, você se agradecerá mais tarde quando seu site continuar funcionando sem problemas.

Perguntas Frequentes Sobre o Erro de Conexão com o Banco de Dados do WordPress

Conclusão

Erros de conexão com o banco de dados podem ser frustrantes, mas com a abordagem correta, você pode removê-los do seu site. 

Lembre-se, a prevenção é fundamental! Manutenção regular, backups e atualizações podem economizar muitas dores de cabeça no futuro.

Pronto para dar ao seu site a proteção que ele merece? Experimente o Duplicator Pro para backups automáticos, restaurações em um clique, armazenamento em nuvem e muito mais!

Enquanto você está aqui, acho que você vai gostar destes guias extras do WordPress:

• 20 Erros Mais Comuns do WordPress (E Algumas Correções Rápidas)
• Como a Black Bike Media Resgatou um Banco de Dados Corrompido de 2,4 GB
• Checklist de Segurança do WordPress: Guia Passo a Passo para Proteger Seu Site
• Como Atualizar Seu Banco de Dados WordPress (+ Corrigir o Loop de Atualização Necessária)
• Aqui Estão os Passos de Reparo do Banco de Dados do WordPress Que Eu Mesmo Fiz (Sem Necessidade de Desenvolvedor)