“error establishing a database connection” é provavelmente um dos erros mais comuns e assustadores que os usuários do WordPress podem encontrar. Definitivamente, está intimamente relacionado com a Tela Branca da Morte (WSOD). Esse erro significa que seu site não está mais se comunicando ou acessível ao banco de dados do WordPress e todo o site está fora do ar.
Para tal erro, os webmasters nunca devem levar as coisas de ânimo leve e devem imediatamente tentar corrigir este problema que afeta diretamente o tráfego, SEO, etc. Mas não se preocupe, hoje iremos discutir alguns cenários comuns que levam a esse erro e as soluções correspondentes .
O que é “error establishing a database connection”?
Todas as informações em um site WordPress, como dados de publicação, dados da página, meta informações, configurações de plug-ins, informações de login, etc., são armazenadas em um banco de dados MySQL. Os únicos dados que não são armazenados são o conteúdo de mídia, como imagens e arquivos de tema / plugin / core, como index.php, wp-login.php, etc. Quando alguém visita seu site, o PHP executa o código na página e consulta as informações do banco de dados, que são exibidas no navegador do visitante.
Se por algum motivo isso não funcionar corretamente, ocorrerá um erro ao estabelecer a conexão com o banco de dados, conforme mostrado a seguir. A página inteira fica em branco porque a conexão não funciona corretamente e nenhum dado pode ser recuperado para renderizar a página. Isso não apenas quebra o front-end do site, mas também torna impossível acessar o painel do WordPress.
No entanto, os visitantes podem não ver esse erro imediatamente no front-end. Isso ocorre porque o cache do site ainda está disponível para acesso até que expire.
Cenários comuns que levam a "error establishing a database connection"
O problema mais comum são as credenciais de login do banco de dados incorretas
O site WordPress precisa usar as informações de login relacionadas ao banco de dados para se conectar ao banco de dados MySQL correspondente.
O banco de dados está corrompido.
Uma vez que os temas e os plug-ins podem ser instalados e desinstalados, a constante remoção e instalação ao longo dos anos pode às vezes levar à corrupção do banco de dados. Isso pode ser devido a tabelas ausentes ou individualmente corrompidas, ou algumas informações podem ter sido excluídas acidentalmente.
Pode haver arquivos corrompidos na instalação do WordPress.
Problemas do servidor de banco de dados
Pode haver muitos problemas no lado do host da web, como o banco de dados estar sobrecarregado devido a picos de tráfego ou não responder devido a muitas conexões simultâneas. Na verdade, com hospedagem compartilhada, isso é bastante comum, pois muitos sites compartilham os recursos de um host.
Como corrigir “error establishing a database connection”
Antes de começar a solucionar o erro, é recomendável primeiro fazer um backup do banco de dados, pois muitas das sugestões a seguir envolvem a manipulação das informações do banco de dados. Independentemente do seu nível de habilidade, você sempre deve fazer um backup antes de tentar modificar o banco de dados do seu site WordPress.
Você pode usar um plugin de backup do WordPress, como VaultPress ou WP Time Capsule para fazer backup de arquivos e bancos de dados.
Se você é um usuário cPanel, é muito fácil fazer backup dos arquivos e banco de dados do seu site. Vá para o painel do cPanel, encontre “Backup” no menu e faça backup de todo o banco de dados e arquivos do site manualmente.
Obviamente, você também pode realizar um backup manual dos arquivos do seu site, acessando o servidor por meio de ferramentas como SFTP, e um backup manual do seu banco de dados MySQL, por meio do phpMyAdmin. Assim que o backup for bem-sucedido, é hora de começar a solucionar o problema “error establishing a database connection”.
Verifique as credenciais de login do banco de dados
A primeira coisa a fazer é verificar se as credenciais de login do banco de dados para o arquivo de configuração do WordPress estão corretas. Essa é de longe a causa mais comum de erros “error establishing a database connection”, especialmente após a migração de um site para um novo provedor de hospedagem. Os detalhes da conexão de um site WordPress são armazenados no arquivo wp-config.php, que geralmente está localizado no diretório raiz.
Ele contém quatro informações importantes que devem ser corretas para que a conexão ao banco de dados seja bem-sucedida.
Nome do banco de dados
// ** MySQL settings ** //
/** The name of the database for WordPress */
define('DB_NAME', 'xxxxxx');
Nome de usuário do banco de dados
/** MySQL database username */
define('DB_USER', 'xxxxxx');
Senha do banco de dados
/** MySQL database password */
define('DB_PASSWORD', 'xxxxxxxxx');
Nome de host MySQL
/** MySQL hostname */
define('DB_HOST', 'localhost');
Para acessar o arquivo wp-config.php, você pode se conectar ao site via SFTP e navegar até o diretório raiz do site. Ou, se você estiver usando o cPanel, pode ir ao painel do cPanel e clicar em “Gerenciador de arquivos”, navegar até o diretório raiz do site e clicar com o botão direito do mouse para editar o arquivo.
A seguir está um exemplo da aparência do arquivo wp-config.php.
Verifique as credenciais do banco de dados no painel cPanel
A primeira coisa a verificar é o nome do banco de dados. Para isso, você precisa ir ao painel de controle do cPanel e fazer o login no phpMyAdmin.
Encontre o nome do banco de dados correspondente ao seu site no menu à esquerda. Ignore o banco de dados “information_schema”, pois este é o banco de dados usado pelo host. Em seguida, compare esse nome com o valor DB_NAME no arquivo wp-config.php. Se forem iguais, isso não é um problema. Se eles não corresponderem, você precisará atualizar o arquivo wp-config.php.
Você também pode verificar se este é o banco de dados correto, certificando-se de que o banco de dados contém a URL do seu site. Basta clicar no banco de dados e, em seguida, clicar na tabela wp_options (por motivos de segurança, este nome pode ser um pouco diferente, por exemplo, wpxx_options). No topo da tabela, você verá os valores para o URL e o nome do site. Se corresponderem ao seu site atual, este é o banco de dados do seu site.
Se o nome do banco de dados estiver correto, mas você ainda receber um erro ao estabelecer a conexão com o banco de dados, também será necessário verificar o nome de usuário e a senha. Para fazer isso, você precisa criar um novo arquivo PHP no diretório raiz do seu site WordPress (nomeá-lo aleatoriamente, por exemplo, checkdb.php) e inserir o código a seguir, que precisa ser substituído pelos valores de db_user e db_password usando o valores do arquivo wp-config.php.
<?php $test = mysqli_connect ('localhost', 'db_user', 'db_password'); if (! $test) { die(‘MySQL Error: ‘ . mysqli_error()); } echo ‘Database connection is working properly!’; mysqli_close ($testConnection); ?>
Visite https://yourdomain.com/checkdb.php com seu navegador. Se você receber “Erro MySQL: Acesso negado”, seu nome de usuário ou senha estão incorretos e você precisará ir para a próxima etapa para redefinir as credenciais.
No entanto, se mostrar “A conexão do banco de dados está funcionando corretamente.”, O nome de usuário e a senha do banco de dados estão corretos. Certifique-se de excluir este arquivo quando terminar o teste.
Se você tiver certeza de que o nome de usuário e a senha do banco de dados estão incorretos, será necessário redefini-los. No cPanel, clique em “Banco de dados MySQL”.
Role para baixo e crie um novo usuário MySQL. Tente selecionar um nome de usuário e senha exclusivos (você pode usar a ferramenta geradora de senha fornecida para gerar uma senha forte) para que não seja adivinhada facilmente. Em seguida, clique em “Criar usuário”. Como alternativa, você pode alterar a senha do usuário do banco de dados atual nesta tela.
Em seguida, role para baixo e adicione o novo usuário ao banco de dados. A próxima tela solicitará os privilégios que deseja atribuir, selecione “Todos os privilégios”
Em seguida, use essas novas credenciais e atualize para o arquivo wp-config.php (atualize os valores DB_USER e DB_PASSWORD). Nesse ponto, você também pode verificar se as informações de credencial do banco de dados estão corretas usando o arquivo de teste mencionado anteriormente. No entanto, se isso não resolver o problema, pode ser que o nome do host (DB_HOST) esteja errado. Alguns hosts usam valores diferentes, você pode consultar alguma lista de valores de host de banco de dados comum ou verificar a documentação relacionada ao host e entrar em contato com o provedor de hospedagem para fornecer. Algumas pessoas também podem usar 127.0.0.1 em vez de localhost.
Conclusão
Como você pode ver, existem muitas maneiras de corrigir o problema “error establishing a database connection” no WordPress. O erro mais comum é que as credenciais do banco de dados definidas no arquivo wp-config.php estão incorretas, portanto, verificar se estão corretas deve ser o primeiro passo. Independentemente do que esteja causando o “error establishing a database connection”, esperamos que as etapas acima ajudem você a colocar seu site novamente em funcionamento. Lembre-se, sempre faça um backup do seu site para restaurá-lo, se necessário.
Português 
English 
Français 
日本語 
Deutsch (Sie) 
Italiano 
Polski 
ไทย 
Bahasa Indonesia 
Español
Como corrigir rapidamente "error establishing a database connection" no WordPress
“error establishing a database connection” é provavelmente um dos erros mais comuns e assustadores que os usuários do WordPress podem encontrar. Definitivamente, está intimamente relacionado com a Tela Branca da Morte (WSOD). Esse erro significa que seu site não está mais se comunicando ou acessível ao banco de dados do WordPress e todo o site está fora do ar.
Para tal erro, os webmasters nunca devem levar as coisas de ânimo leve e devem imediatamente tentar corrigir este problema que afeta diretamente o tráfego, SEO, etc. Mas não se preocupe, hoje iremos discutir alguns cenários comuns que levam a esse erro e as soluções correspondentes .
O que é “error establishing a database connection”?
Todas as informações em um site WordPress, como dados de publicação, dados da página, meta informações, configurações de plug-ins, informações de login, etc., são armazenadas em um banco de dados MySQL. Os únicos dados que não são armazenados são o conteúdo de mídia, como imagens e arquivos de tema / plugin / core, como index.php, wp-login.php, etc. Quando alguém visita seu site, o PHP executa o código na página e consulta as informações do banco de dados, que são exibidas no navegador do visitante.
Se por algum motivo isso não funcionar corretamente, ocorrerá um erro ao estabelecer a conexão com o banco de dados, conforme mostrado a seguir. A página inteira fica em branco porque a conexão não funciona corretamente e nenhum dado pode ser recuperado para renderizar a página. Isso não apenas quebra o front-end do site, mas também torna impossível acessar o painel do WordPress.
No entanto, os visitantes podem não ver esse erro imediatamente no front-end. Isso ocorre porque o cache do site ainda está disponível para acesso até que expire.
Cenários comuns que levam a "error establishing a database connection"
O problema mais comum são as credenciais de login do banco de dados incorretas
O site WordPress precisa usar as informações de login relacionadas ao banco de dados para se conectar ao banco de dados MySQL correspondente.
O banco de dados está corrompido.
Uma vez que os temas e os plug-ins podem ser instalados e desinstalados, a constante remoção e instalação ao longo dos anos pode às vezes levar à corrupção do banco de dados. Isso pode ser devido a tabelas ausentes ou individualmente corrompidas, ou algumas informações podem ter sido excluídas acidentalmente.
Pode haver arquivos corrompidos na instalação do WordPress.
Problemas do servidor de banco de dados
Pode haver muitos problemas no lado do host da web, como o banco de dados estar sobrecarregado devido a picos de tráfego ou não responder devido a muitas conexões simultâneas. Na verdade, com hospedagem compartilhada, isso é bastante comum, pois muitos sites compartilham os recursos de um host.
Como corrigir “error establishing a database connection”
Antes de começar a solucionar o erro, é recomendável primeiro fazer um backup do banco de dados, pois muitas das sugestões a seguir envolvem a manipulação das informações do banco de dados. Independentemente do seu nível de habilidade, você sempre deve fazer um backup antes de tentar modificar o banco de dados do seu site WordPress.
Você pode usar um plugin de backup do WordPress, como VaultPress ou WP Time Capsule para fazer backup de arquivos e bancos de dados.
Se você é um usuário cPanel, é muito fácil fazer backup dos arquivos e banco de dados do seu site. Vá para o painel do cPanel, encontre “Backup” no menu e faça backup de todo o banco de dados e arquivos do site manualmente.
Obviamente, você também pode realizar um backup manual dos arquivos do seu site, acessando o servidor por meio de ferramentas como SFTP, e um backup manual do seu banco de dados MySQL, por meio do phpMyAdmin. Assim que o backup for bem-sucedido, é hora de começar a solucionar o problema “error establishing a database connection”.
Verifique as credenciais de login do banco de dados
A primeira coisa a fazer é verificar se as credenciais de login do banco de dados para o arquivo de configuração do WordPress estão corretas. Essa é de longe a causa mais comum de erros “error establishing a database connection”, especialmente após a migração de um site para um novo provedor de hospedagem. Os detalhes da conexão de um site WordPress são armazenados no arquivo wp-config.php, que geralmente está localizado no diretório raiz.
Ele contém quatro informações importantes que devem ser corretas para que a conexão ao banco de dados seja bem-sucedida.
Nome do banco de dados
Nome de usuário do banco de dados
Senha do banco de dados
Nome de host MySQL
Para acessar o arquivo wp-config.php, você pode se conectar ao site via SFTP e navegar até o diretório raiz do site. Ou, se você estiver usando o cPanel, pode ir ao painel do cPanel e clicar em “Gerenciador de arquivos”, navegar até o diretório raiz do site e clicar com o botão direito do mouse para editar o arquivo.
A seguir está um exemplo da aparência do arquivo wp-config.php.
Verifique as credenciais do banco de dados no painel cPanel
A primeira coisa a verificar é o nome do banco de dados. Para isso, você precisa ir ao painel de controle do cPanel e fazer o login no phpMyAdmin.
Encontre o nome do banco de dados correspondente ao seu site no menu à esquerda. Ignore o banco de dados “information_schema”, pois este é o banco de dados usado pelo host. Em seguida, compare esse nome com o valor DB_NAME no arquivo wp-config.php. Se forem iguais, isso não é um problema. Se eles não corresponderem, você precisará atualizar o arquivo wp-config.php.
Você também pode verificar se este é o banco de dados correto, certificando-se de que o banco de dados contém a URL do seu site. Basta clicar no banco de dados e, em seguida, clicar na tabela wp_options (por motivos de segurança, este nome pode ser um pouco diferente, por exemplo, wpxx_options). No topo da tabela, você verá os valores para o URL e o nome do site. Se corresponderem ao seu site atual, este é o banco de dados do seu site.
Se o nome do banco de dados estiver correto, mas você ainda receber um erro ao estabelecer a conexão com o banco de dados, também será necessário verificar o nome de usuário e a senha. Para fazer isso, você precisa criar um novo arquivo PHP no diretório raiz do seu site WordPress (nomeá-lo aleatoriamente, por exemplo, checkdb.php) e inserir o código a seguir, que precisa ser substituído pelos valores de db_user e db_password usando o valores do arquivo wp-config.php.
<?php
$test = mysqli_connect ('localhost', 'db_user', 'db_password');
if (! $test) {
die(‘MySQL Error: ‘ . mysqli_error());
}
echo ‘Database connection is working properly!’;
mysqli_close ($testConnection);
?>
Visite https://yourdomain.com/checkdb.php com seu navegador. Se você receber “Erro MySQL: Acesso negado”, seu nome de usuário ou senha estão incorretos e você precisará ir para a próxima etapa para redefinir as credenciais.
No entanto, se mostrar “A conexão do banco de dados está funcionando corretamente.”, O nome de usuário e a senha do banco de dados estão corretos. Certifique-se de excluir este arquivo quando terminar o teste.
Se você tiver certeza de que o nome de usuário e a senha do banco de dados estão incorretos, será necessário redefini-los. No cPanel, clique em “Banco de dados MySQL”.
Role para baixo e crie um novo usuário MySQL. Tente selecionar um nome de usuário e senha exclusivos (você pode usar a ferramenta geradora de senha fornecida para gerar uma senha forte) para que não seja adivinhada facilmente. Em seguida, clique em “Criar usuário”. Como alternativa, você pode alterar a senha do usuário do banco de dados atual nesta tela.
Em seguida, role para baixo e adicione o novo usuário ao banco de dados. A próxima tela solicitará os privilégios que deseja atribuir, selecione “Todos os privilégios”
Em seguida, use essas novas credenciais e atualize para o arquivo wp-config.php (atualize os valores DB_USER e DB_PASSWORD). Nesse ponto, você também pode verificar se as informações de credencial do banco de dados estão corretas usando o arquivo de teste mencionado anteriormente. No entanto, se isso não resolver o problema, pode ser que o nome do host (DB_HOST) esteja errado. Alguns hosts usam valores diferentes, você pode consultar alguma lista de valores de host de banco de dados comum ou verificar a documentação relacionada ao host e entrar em contato com o provedor de hospedagem para fornecer. Algumas pessoas também podem usar 127.0.0.1 em vez de localhost.
Conclusão
Como você pode ver, existem muitas maneiras de corrigir o problema “error establishing a database connection” no WordPress. O erro mais comum é que as credenciais do banco de dados definidas no arquivo wp-config.php estão incorretas, portanto, verificar se estão corretas deve ser o primeiro passo. Independentemente do que esteja causando o “error establishing a database connection”, esperamos que as etapas acima ajudem você a colocar seu site novamente em funcionamento. Lembre-se, sempre faça um backup do seu site para restaurá-lo, se necessário.
Postagens relacionadas:
Relacionado