Erro ao estabelecer conexão com o banco de dados no WordPress: como resolver

Comente! ,

Tempo de leitura: 3 minutos

O site abre uma página branca com uma única frase: “Erro ao estabelecer uma conexão com o banco de dados”. Nada de conteúdo, nada de painel. Parece grave, mas o erro ao estabelecer conexão com o banco de dados tem poucas causas possíveis, e dá para testar todas em poucos minutos.

Na hospedagem da Rubfy você confere tudo isso pelo cPanel e conta com suporte humano se precisar. Se você ainda não tem onde rodar isso, a Hospedagem de Sites Rubfy já entrega o servidor pronto.

O que o erro significa

O WordPress guarda tudo (posts, páginas, usuários, configurações) num banco MySQL ou MariaDB. A cada visita, ele se conecta ao banco usando os dados do arquivo wp-config.php. Se a conexão falha, ele não tem o que mostrar.

As causas mais comuns são:

  1. Dados errados no wp-config.php.
  2. Usuário do banco sem permissão ou com senha alterada.
  3. Servidor de banco fora do ar ou sobrecarregado.
  4. Tabelas corrompidas.

Passo 1: conferir o wp-config.php

Abra o arquivo wp-config.php pelo Gerenciador de Arquivos e localize estas linhas:

define( 'DB_NAME', 'usuario_wp123' );
define( 'DB_USER', 'usuario_wp123' );
define( 'DB_PASSWORD', 'senha' );
define( 'DB_HOST', 'localhost' );

No cPanel, o nome do banco e do usuário sempre começam com o nome da conta seguido de sublinhado. Compare com o que aparece em Bancos de dados MySQL. Um caractere diferente basta para o erro.

Passo 2: redefinir a senha do usuário

Se você não tem certeza da senha:

  1. No cPanel, abra Bancos de dados MySQL.
  2. Em Usuários atuais, clique em Alterar senha no usuário do WordPress.
  3. Gere uma senha nova, copie e salve.
  4. Cole a mesma senha em DB_PASSWORD no wp-config.php.

Passo 3: conferir se o usuário está ligado ao banco

Na mesma página, em Bancos de dados atuais, veja se o usuário aparece na coluna de usuários privilegiados do banco. Se não aparecer, use Adicionar usuário ao banco de dados, escolha os dois e marque Todos os privilégios.

Esse problema é muito comum depois de uma migração ou da restauração de um backup.

Passo 4: verificar se o banco está no ar

Se os dados estão certos e o erro continua, teste se o phpMyAdmin abre o banco. Se nem ele conecta, o serviço de banco pode estar fora ou sobrecarregado. Na hospedagem compartilhada, fale com o suporte. Numa VPS, confira o serviço:

sudo systemctl status mariadb
sudo systemctl restart mariadb

Se o MariaDB cai sozinho com frequência, pode ser falta de memória. Veja quanto de RAM sua VPS precisa e considere criar swap.

Passo 5: reparar tabelas corrompidas

Se o painel em /wp-admin mostra uma mensagem diferente, falando em tabelas que precisam de reparo, adicione temporariamente ao wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Acesse seusite.com.br/wp-admin/maint/repair.php, clique em Reparar banco de dados e, ao terminar, remova a linha, porque essa página não pede senha.

No cPanel, também é possível reparar pelo Bancos de dados MySQL > Reparar banco de dados.

Passo 6: o erro aparece só às vezes

Erro intermitente, que vai e volta, geralmente indica limite de conexões ou de recursos atingido em horários de pico. Um plugin de cache reduz muito as consultas ao banco. Em sites maiores, é sinal de que está na hora de mais recursos.

Banco de dados estável, site no ar

Com os dados certos no wp-config e um servidor bem dimensionado, esse erro vira coisa do passado. Na Hospedagem de Sites Rubfy você conta com cPanel oficial, Sitejet com inteligência artificial incluso, servidor LiteSpeed, backups com JetBackup, antivírus premium, migração gratuita, servidores no Brasil e suporte humano via WhatsApp e ticket. Fale com a equipe pelo WhatsApp e escolha o plano ideal para o seu projeto.

Artigos relacionados