Como corrigir “Erro ao estabelecer uma conexão com o banco de dados”

Ah, o temido “Erro ao estabelecer uma conexão com o banco de dados”, dum, dum, dum (imagine uma música sinistra tocando). Se você é um designer ou desenvolvedor experiente do WordPress, provavelmente pode ir direto para corrigir esse erro. Mas para aqueles que são novos no WordPress, isso pode ser uma mensagem de erro assustadora.

Você pode ver esse erro ao tentar instalar o WordPress manualmente ou verá esse erro em uma fonte preta grande em uma tela branca em seu navegador ao tentar acessar seu site ou ambiente de desenvolvimento local. A última é a versão mais assustadora desse erro, porque geralmente o pega desprevenido.

Claro, qualquer bom host WordPress gerenciado deve configurar tudo para você e garantir que esses erros nunca ocorram. Mas se você estiver usando um host WordPress que faz com que você instale e gerencie o WordPress por conta própria, ou se estiver desenvolvendo em seu computador local, você pode se deparar com esse problema.

De todos os arquivos PHP do WordPress necessários para executar o WordPress, wp-config.php é o mais importante porque sem esse arquivo, seu site não pode se conectar ao banco de dados e seu site não funcionará. Este arquivo é onde você define suas informações de conexão com o banco de dados, como Nome do Banco de Dados, Nome de Usuário, Senha e Host. Em hosts como o Flywheel, você não pode editar esse arquivo, pois ele está configurado para você. Você pode pular este próximo motivo com segurança se estiver usando um host gerenciado.

O motivo mais comum para este erro

A razão mais comum pela qual você recebe o infame “Erro ao estabelecer uma conexão de banco de dados” é devido a configurações incorretas de conexão de banco de dados em wp-config.php . Ao mover um site de uma antiga empresa de hospedagem, certifique-se de atualizar o nome do banco de dados, o nome de usuário do banco de dados e a senha do banco de dados em seu arquivo wp-config.php para refletir o novo banco de dados em sua nova hospedagem.

Movendo incorretamente seu site WordPress

Um problema comum que vi é quando alguém move seus arquivos do WordPress para uma nova empresa de hospedagem e depois aponta o nome de domínio para o novo host, mas não move seu banco de dados.

Torne seu site rápido: Parte 2

Na semana passada, falei sobre como acelerar seu site com foco no desempenho do front-end. E embora isso possa ser extremamente útil para acelerar seu site, não se esqueça - há o back-...

O site ainda aparecerá quando você acessar a URL e o site ainda funcionará. O problema aqui é que, quando você finalmente cancelar sua hospedagem antiga, o site ficará inativo porque você estava se conectando ao banco de dados na conta de hospedagem antiga, produzindo assim a mensagem de erro “Erro ao estabelecer uma conexão com o banco de dados”.

A melhor prática é mover tudo para sua nova empresa de hospedagem e atualizar seu arquivo wp-config.php para refletir o novo banco de dados. Dessa forma, você pode cancelar com confiança sua antiga conta de hospedagem sem perder nenhum dado e ver o temido erro “Erro ao estabelecer uma conexão com o banco de dados”.

Se você estiver no Flywheel, eles apenas moverão tudo para você e garantirão que você esteja funcionando, eliminando o incômodo de ter que descobrir qualquer uma dessas configurações.

Seu arquivo wp-config.php é o primeiro lugar que você deve começar ao tentar corrigir esse problema. Se você verificar se suas informações de conexão estão realmente corretas, passe para essas outras correções descritas abaixo.

Pode haver uma variedade de razões pelas quais esse erro acontece e vou guiá-lo por alguns cenários adicionais. Não se preocupe - você não precisa ser um assistente de desenvolvedor para corrigir esse erro.

Antes de tentar qualquer uma dessas correções abaixo, certifique-se de criar um backup do seu banco de dados. Você pode fazer isso através do seu painel de controle de hospedagem acessando o phpMyAdmin e exportando o arquivo SQL.

Vamos mergulhar?

Causa 1. Você esqueceu de atualizar seu arquivo wp-config.php quando alterou a senha do banco de dados

Atualizar uma senha de banco de dados para que seu banco de dados fique mais seguro é uma coisa muito boa a se fazer. Uma senha forte é o melhor tipo de senha. Lembre-se que quando você altera a senha de um banco de dados no painel de controle de sua hospedagem, você também precisa alterar a senha em seu arquivo wp-config.php .

A boa notícia é que esta é uma solução fácil. Tudo o que você precisa fazer é abrir o arquivo wp-config.php e adicionar a nova senha.

Baixe seu arquivo wp-config.php , abra um editor de texto e edite a seguinte linha:

define('DB_PASSWORD', 'password-goes-here');

Adicione sua nova senha, salve o arquivo wp-config.php e faça o upload via FTP. Atualize seu site e veja se ele volta. Se assim for, você está feito. Parabéns – você ganha todos os pontos de Internet!

Nota: Certifique-se de deixar aspas simples ao redor da senha, e também não deve haver espaços entre as aspas simples e sua senha.

Fácil peasy certo?

Essencialmente, o que você está fazendo é garantir que as informações de conexão do banco de dados sejam atualizadas para refletir a nova senha do banco de dados.

Mais uma vez, se você estiver em um host como o Flywheel, esta etapa não se aplica a você e você pode seguir em frente com segurança!

Causa 2. Você inseriu suas informações de banco de dados incorretamente durante a famosa “instalação de 5 minutos” do WordPress

Erros de digitação são literalmente a ruína de nossa existência ao trabalhar online; um pequeno erro de digitação pode travar um site e, neste caso, o sublinhado errado ou o esquecimento de uma letra ou número do nome do banco de dados, nome de usuário ou senha tem o mesmo efeito de travamento.

A maioria das instalações do WordPress são tratadas através do seu painel de controle de hospedagem usando um assistente nos dias de hoje, ou feitas completamente para você no Managed WordPress. Mas algumas pessoas gostam de instalar manualmente. Ouvi dizer que as instalações manuais ainda são uma coisa.

Se você optar por instalar o WordPress da maneira Ye Olde Fashioned, criando manualmente um banco de dados e carregando manualmente o software WordPress via FTP, você precisa salvar as informações do usuário do banco de dados ao criar seu banco de dados. É aqui que copiar e colar realmente é útil.

No entanto, certifique-se de que, ao copiar essas informações, copie apenas o texto necessário. Você sabia que copiar um espaço em branco extra após o nome do banco de dados, nome de usuário ou senha será lido como um caractere? Este caractere em branco extra lhe dará erros quando o instalador tentar se conectar ao seu banco de dados.

Além disso, certifique-se de inserir as informações no campo apropriado durante a instalação. Na verdade, eu tive um peido cerebral uma vez e percebi que estava digitando o nome do banco de dados no campo errado. Uma vez corrigido, a instalação ocorreu sem problemas!

Causa 3. Ao mover um site WordPress para um novo host, DB_HOST pode ser algo exclusivo desse host

Mesmo que você tenha atualizado seu arquivo wp-config.php para refletir as novas informações de conexão do banco de dados em sua nova empresa de hospedagem, talvez seja necessário alterar seu campo DB_HOST .

Esse problema é mais raro, mas acontece. Algumas empresas de hospedagem usam seus próprios valores exclusivos ao definir o parâmetro DB_Host em wp-config , mas isso nem sempre é o caso. Outros hosts realmente definem uma URL para o servidor de banco de dados MySQL e isso precisa ser refletido como o valor para DB_HOST . Alguns usuários também tiveram sucesso usando seu endereço IP de hospedagem no lugar de uma URL do MySQL ou localhost, então você pode tentar isso também.

Se você estiver no Flywheel, isso é feito automaticamente para você, então você não precisa se preocupar.

Causa 4. Seu banco de dados está corrompido

Este erro não é o mesmo que “Erro ao estabelecer uma conexão com o banco de dados”, mas está um pouco relacionado. Às vezes, o front-end do seu site funciona bem, mas você recebe um erro como “Uma ou mais tabelas de banco de dados não estão disponíveis, o banco de dados pode precisar ser reparado” no back-end. Isso significa que você deve reparar o banco de dados.

Aqui está a correção para este erro:

Abra seu arquivo wp-config.php e vá para a seção que define o nome do seu banco de dados, nome de usuário, senha e host. Em Host, defina o seguinte:

define('WP_ALLOW_REPAIR', true);

Em seguida, salve seu arquivo wp-config.php , faça o upload via FTP e vá para este URL:

Isso abrirá uma página com duas opções. A primeira opção é um botão que diz "Reparar banco de dados" e a segunda opção é um botão que diz "Reparar e otimizar banco de dados"

Eu tenho que reiterar a importância de fazer backup de seu banco de dados antes de fazer esta etapa. Mesmo que você não possa se conectar, não significa que você não deva ter um backup.

Clique na opção “Reparar Banco de Dados” e assim que o processo de reparo terminar abra uma nova aba e acesse sua URL e veja se a mensagem “Erro ao estabelecer uma conexão com o banco de dados” desapareceu e se seu site voltou ao normal.

Se essa correção não funcionar e as correções acima não funcionarem, há uma última causa que você deve conhecer.

A maioria dos hosts gerenciados fará backup de seus dados diariamente para você, portanto, se esse cenário não tão bom acontecer, às vezes é mais fácil restaurar do backup de ontem e continuar em movimento.

Causa 5. O servidor de banco de dados MySQL está inativo.

Isso tende a acontecer para pessoas que estão levando sua hospedagem compartilhada ao limite. Se o seu site recebe muito tráfego, isso pode simplesmente sobrecarregar o servidor de banco de dados. Saudações para você por ter um site que recebe todo esse tráfego doce, mas se você receber a mensagem “Erro ao estabelecer uma conexão com o banco de dados” e tiver tentado as outras correções, talvez seja necessário atualizar.

Em um host compartilhado, muitos sites podem ser amontoados no mesmo servidor. Se alguém recebe muito tráfego ou é apenas um vizinho barulhento em geral, pode causar um grande problema para o resto dos sites. Em hosts gerenciados como o Flywheel, cada site recebe seu próprio servidor, portanto, esse problema é facilmente resolvido.

Mas antes de pular direto para uma atualização de hospedagem, você deve ligar para sua empresa de hospedagem e pedir que verifiquem o status do servidor de banco de dados. Talvez haja um problema técnico ou talvez sua empresa de hospedagem tenha enviado um e-mail sobre a manutenção programada do servidor e você perdeu esse e-mail. Embora seja altamente improvável que você veja a mensagem “Erro ao estabelecer uma conexão com o banco de dados” resultante da manutenção do servidor, já vi isso uma vez na minha carreira e de qualquer forma, vale a pena ligar para descobrir.

Fale com sua empresa de hospedagem e explique que você tentou essas várias correções sem sucesso e peça para que analisem isso. Se eles disserem que seu site está produzindo bastante carga no servidor e recomendarem uma atualização de hospedagem, parabéns, você é incrível! Lembre-se de que essas atualizações significam que seu site está arrasando!

O embrulho

Como você pode ver, corrigir o erro “Erro ao estabelecer a conexão com o banco de dados” não é tão assustador quanto você pensava. Basta um pouco de diligência para verificar se você está definindo as configurações de banco de dados apropriadas em seu arquivo wp-config.php . Em alguns casos, é preciso cavar mais fundo para resolver o problema. E no final do dia, sua empresa de hospedagem está lá para te apoiar.

Saiba mais sobre Volante

Seja qual for o seu ambiente de trabalho, a poderosa plataforma WordPress do Flywheel elimina todos os aborrecimentos da hospedagem, agiliza seus processos e permite que você volte a fazer seu melhor trabalho.

Saiba mais aqui.