Como corrigir o erro ao estabelecer uma conexão de banco de dados
Publicados: 2022-06-21O “erro ao estabelecer uma conexão com o banco de dados” é um erro comum do WordPress e pode causar pânico especialmente para iniciantes. Isso ocorre porque, uma vez que você encontre o erro em seu site, você não poderá visualizar nenhum outro conteúdo do site. Há apenas uma tela em branco com o texto.
Esse erro pode ser frustrante para os usuários do seu site, pois eles não podem visualizar nada no site. Felizmente este erro pode ser corrigido. É importante corrigir esse erro o mais rápido possível.
Neste artigo, veremos o que é o “erro ao estabelecer uma conexão com o banco de dados”, suas causas comuns e como corrigir o erro.
Índice
O que é o "Erro ao estabelecer uma conexão de banco de dados"
Causas comuns do erro
Como corrigir “Erro ao estabelecer uma conexão de banco de dados” no WordPress
- Verifique suas credenciais de login do banco de dados
- Repare seu banco de dados WordPress
- Verificação de temas e plugins
- Corrigindo arquivos corrompidos do WordPress
- Consulte seu provedor de hospedagem
Conclusão
O que é o "Erro ao estabelecer uma conexão de banco de dados"
Esse erro basicamente significa que seu site não está em condições de se conectar ao seu banco de dados.
Para obter uma compreensão completa do erro, vamos começar abordando como o sistema de gerenciamento de conteúdo do WordPress funciona.
O WordPress depende de duas tecnologias para funcionar corretamente. Estes incluem PHP, que é uma linguagem de programação do lado do servidor, e MySQL, que é um servidor de banco de dados.
Todas as funcionalidades do WordPress são definidas em arquivos estáticos que são codificados em PHP. O servidor de banco de dados MySQL, por outro lado, gerencia bancos de dados WordPress. Um banco de dados WordPress armazena todos os dados em seu site, como postagens, páginas e itens de mídia.
Quando um usuário digita uma URL em seu navegador, o PHP busca o conteúdo do seu banco de dados e esse conteúdo é apresentado em seu navegador. Se o usuário for apresentado com o “Erro ao estabelecer uma conexão com o banco de dados”, isso significa que o PHP não pode se conectar ao seu banco de dados para buscar o conteúdo solicitado.
Abaixo está uma exibição de amostra do erro:
Na captura de tela acima, a conexão PHP-MySQL não está presente, portanto, o erro é gerado.
Causas comuns do erro
Existem várias razões pelas quais você pode encontrar o “erro ao estabelecer uma conexão com o banco de dados”. Alguns deles incluem:
Credenciais de banco de dados incorretas
Na verdade, essa é uma das causas comuns relatadas desse erro.
Semelhante ao seu painel do WordPress, onde você precisa de um nome de usuário e senha para fazer login, também seu site requer credenciais para se conectar ao seu banco de dados. Se essas credenciais forem alteradas por acaso, seu site apresentará o “erro ao estabelecer uma conexão com o banco de dados”.
Servidor sobrecarregado
Se o seu servidor pode ter várias solicitações do que pode lidar em um determinado momento, isso também pode levar ao “erro ao estabelecer uma conexão com o banco de dados”.
Isso é especialmente comum em sites executados em uma hospedagem compartilhada.
Banco de dados corrompido
Alterações manuais desnecessárias em seu banco de dados podem torná-lo corrompido. Por exemplo, se você excluir uma linha ou tabela em seu banco de dados que talvez seja necessária para que ocorra uma conexão com o banco de dados, é provável que você encontre o "erro ao estabelecer uma conexão com o banco de dados".
Temas e plugins mal codificados também podem levar a um banco de dados corrompido. Se, por exemplo, você tiver um plug-in que raramente é atualizado, os hackers podem explorar o plug-in e usá-lo para executar consultas SQL que alteram o conteúdo do banco de dados, levando a um banco de dados corrompido.
Arquivos corrompidos do WordPress
Outra causa para o erro é ter arquivos corrompidos do WordPress em sua instalação. É possível que você tenha arquivos do WordPress que possam ter sido modificados para infringir a conexão com o banco de dados. Essa é uma prática usada por hackers para criar um backdoor para seu site, acionando assim o “erro ao estabelecer uma conexão com o banco de dados”.
Falhas nas atualizações do WordPress também são uma causa provável de arquivos corrompidos do WordPress.
Como corrigir “Erro ao estabelecer uma conexão de banco de dados” no WordPress
Apesar do pânico causado pelo “Erro ao estabelecer uma conexão com o banco de dados”, esse erro pode ser corrigido. No entanto, recomendamos a realização de um backup completo do seu site antes de realizar qualquer alteração. Aqui está um guia sobre como fazer backup do seu site WordPress.
Uma vez feito o backup completo, agora você pode continuar experimentando as correções compartilhadas abaixo.
Verifique suas credenciais de login do banco de dados
Para que seu site se conecte ao seu banco de dados, as credenciais do banco de dados são necessárias. Essas credenciais são armazenadas no arquivo Wp-config.php que está na raiz dos seus arquivos do WordPress. Você pode acessar o arquivo via FTP com a ajuda de um software FTP como o Filezilla. Alternativamente, você pode acessar o arquivo através do seu painel de hospedagem, como o cPanel. Abaixo está uma ilustração de captura de tela no arquivo:
Depois de localizar o arquivo, selecione para editá-lo e dentro dele você encontrará os detalhes abaixo que são necessários para que seu site acesse o banco de dados:
- O nome do banco de dados (“DB_NAME”)
- O nome de usuário do banco de dados MySQL (“DB_USER”)
- A senha do banco de dados MySQL (“DB_PASSWORD”)
- O nome do host MySQL (“DB_HOST”)
Abaixo está uma captura de tela desses detalhes:
Agora você precisa verificar se esses detalhes correspondem aos do gerenciador de banco de dados.
Para começar, primeiro confirmaremos o nome do banco de dados e o nome do host. Quanto a isso, você precisará acessar o phpMyAdmin do seu painel de hospedagem.
Se você estiver usando o cPanel, poderá acessar o phpMyAdmin na seção Bancos de dados, conforme ilustrado abaixo:
Ao acessar o phpMyadmin, clique na aba “Bancos de Dados” e verifique se você possui um banco de dados com um nome semelhante ao que você tem dentro do seu arquivo wp-config.php. Este é o nome após 'DB_ Name' em seu arquivo wp-config.php.
Você pode ignorar o banco de dados information_schema no local, pois este é o banco de dados do host.
Ainda na mesma seção, verifique seu servidor de banco de dados. Isso pode ser verificado ao clicar em seu banco de dados e verificar o nome do servidor. Abaixo está uma ilustração de exemplo sobre isso:
Você precisará comparar isso com o valor em seu arquivo wp-confg.php em DB_Host.
A próxima etapa é verificar as credenciais do usuário.
Se o seu site estiver no cPanel, você pode verificar essas informações na seção "Bancos de dados MySQL".
Clique nele e verifique a seção "Usuários atuais". Aqui, você deve ter uma visão do nome de usuário e um link para alterar sua senha, conforme ilustrado na captura de tela abaixo:
Se o nome de usuário não corresponder ao que está no arquivo wp-config.php, altere o valor no arquivo wp-config para o valor na seção de usuários atuais.
Quanto à senha, você pode alterá-la no link “Alterar senha”. Antes de fazer isso, você pode testar rapidamente se as credenciais em seu wp-config.php funcionam.
Para fazer isso, dentro da raiz dos seus arquivos WordPress, crie um arquivo chamado dbtest.php conforme ilustrado abaixo:
Selecione para editar o arquivo e adicione o seguinte código:
<?php $link = mysqli_connect("localhost", "root", "password"); if (!$link) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($link); ?>
Dentro do código, substitua localhost pelo seu nome 'DB_Host' se não for localhost. Também substitua root e senha por seu 'DB_USER' e 'DB_PASSWORD' respectivamente.
Em seguida, acesse o arquivo do seu site pelo navegador digitando o endereço yourdomain.com/dbtest.php . Certifique-se de substituir yourdomain.com pelo URL do domínio real.
Se a conexão for bem-sucedida, você verá a mensagem “Conectado com sucesso”. Abaixo está uma captura de tela de exemplo.
No caso acima, você não precisa alterar suas credenciais, pois é evidente que suas credenciais de login não são a causa do problema.
Pelo contrário, se as credenciais não estiverem corretas, você terá uma visão dessa mensagem “Não foi possível conectar: Acesso negado para usuário…” . Nesse caso, você precisará alterar a senha se o nome de usuário estiver correto, clicando no link “alterar senha”. Alternativamente, você pode criar um novo usuário e usar as novas credenciais dentro do arquivo wp-config.php.
Repare seu banco de dados WordPress
O “Erro ao estabelecer uma conexão com o banco de dados” também pode ser causado por um banco de dados corrompido. Se o erro não for devido às credenciais ou se a conexão foi bem-sucedida na etapa anterior, considere reparar o banco de dados.
Para reparar seu banco de dados, você precisará realizar o seguinte:
i) Acesse seu wp-config.php na raiz dos arquivos do seu tema
ii) Selecione para editar o arquivo wp-config.php
iii) Adicione o código abaixo dentro do arquivo:
define ( 'WP_ALLOW_REPAIR' , true);
O código deve ser adicionado logo antes da linha:
/* That's all, stop editing! Happy publishing. */
iv) Dentro do seu navegador digite sua url no formato yourdomain.com/wp-admin/maint/repair.php . Certifique-se de substituir seudominio.com pelo seu domínio real.
Feito isso, você terá uma visualização dessa exibição em seu site:
Em seguida, clique no botão “Repair Database” para iniciar o processo de reparo automático do banco de dados.
Se isso não resolver o problema, você também poderá experimentar outras soluções oferecidas.
Verificação de temas e plugins
Em alguns casos, temas e plugins que você possui podem causar “Erro ao estabelecer uma conexão com o banco de dados”. Para verificar se você pode realizar o seguinte:
Verificação de plug-ins
i) Acesse os arquivos do seu site via FTP usando um Software como o Filezilla ou um painel de hospedagem como o cPanel
ii) Dentro da raiz dos arquivos do seu site, navegue até a pasta Wp-contents e renomeie a pasta plugins para “plugins-old”
iii) Acesse seu site e veja se o “Erro ao estabelecer conexão com o banco de dados” foi resolvido.
iv) Se o erro for resolvido, renomeie a pasta “plugins-old” de volta para “plugins”
v) Acesse a seção de plugins em seu painel do WordPress e ative os plugins um a um verificando se o erro foi resolvido em alguma instância, a fim de identificar o plugin que está causando o problema.
Depois de identificar o plug-in conflitante, desative-o novamente e consulte o autor dos plug-ins sobre o problema.
Verificação de temas
i) Semelhante à verificação de plugins, acesse os arquivos do seu site via FTP
ii) Na raiz dos arquivos do seu site, navegue até a pasta Wp-content > themes e renomeie seu tema atualmente ativo. Você pode fazer isso adicionando um ponto final a ele
iii) Visite seu site para ver se o “Erro ao estabelecer uma conexão com o banco de dados” foi resolvido
Se o erro for resolvido, isso significa que o problema está sendo causado pelo seu tema. Você precisará consultar o autor do tema ou suporte nesse caso.
Corrigindo arquivos corrompidos do WordPress
Em alguns casos, o erro também pode ser causado por arquivos corrompidos do WordPress, especialmente se um hacker obteve acesso aos arquivos do seu site.
Para verificar se este é o caso, você precisará realizar o seguinte:
i) Faça um backup completo do seu site. Aqui está um guia sobre como fazer isso.
ii) Baixe o WordPress de wordpress.org
iii) Descompacte o download
iv) Exclua a pasta wp-content, bem como os arquivos wp-config.php e wp-config-sample.php.
v) Carregue os arquivos restantes para a raiz dos arquivos do seu site via FTP usando um Software como o Filezilla ou um painel de hospedagem como o cPanel.
Isso substituirá os arquivos existentes por novos arquivos. Feito isso, recarregue sua página da web e veja se o “Erro ao estabelecer uma conexão com o banco de dados” foi resolvido.
Consulte seu provedor de hospedagem
Se as sugestões acima não ajudarem, é aconselhável que você consulte seu provedor de hospedagem sobre o “Erro ao estabelecer uma conexão com o banco de dados”. Pode ser que haja um tempo de inatividade no servidor de banco de dados.
Seu provedor de hospedagem está em condições de verificar o problema e determinar a causa exata e corrigi-lo.
Conclusão
O “Erro ao estabelecer uma conexão com o banco de dados” é um erro comum do WordPress. Se você encontrar o erro em seu site, recomendamos experimentar os métodos acima para resolver o problema. Também é importante que você faça backups completos do seu site, pois eles servem como ótimos pontos de restauração caso ocorra um erro desse tipo.
Esperamos que os métodos descritos acima ajudem a resolver o “Erro ao estabelecer uma conexão com o banco de dados” no futuro. Se você tiver dúvidas ou comentários, sinta-se à vontade para colocá-los na seção de comentários abaixo.