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

Tipo Banco de dados

Nome do erro Como corrigir Error establishing a database connection

Severidade Crítico

Descrição "Error establishing a database connection" significa que o WordPress não conseguiu falar com o MySQL. Quase sempre vem de credenciais erradas no wp-config.php, do servidor de banco fora do ar ou de tabelas corrompidas.

O que é o erro de conexão com o banco de dados?

Esse erro aparece quando o PHP do WordPress não consegue abrir uma conexão com o servidor de banco de dados (MySQL ou MariaDB). Sem essa conexão o WordPress não lê posts, opções nem usuários, então o site inteiro fica fora do ar, mostrando apenas a frase do erro em tela branca.

Como identificar

Tela branca com apenas a frase “Error establishing a database connection”.
O mesmo erro aparece tanto no front-end quanto no wp-admin.
Às vezes o wp-admin mostra “One or more database tables are unavailable” e sugere reparar o banco.
O erro surge após migrar de host, trocar a senha do banco ou em horário de pico de tráfego.

Antes de começar: Faça backup do wp-config.php antes de editá-lo e remova a linha WP_ALLOW_REPAIR assim que terminar o reparo (ela deixa a rota de reparo aberta sem login).

Como prevenir

Anote as credenciais do banco em local seguro e atualize o wp-config.php sempre que trocar a senha
Monitore o uso de recursos do plano para não estourar o limite de conexões em campanhas
Mantenha backups automáticos do banco para restaurar rápido em caso de corrupção

Erros relacionados

Causa

Credenciais erradas no wp-config.php (DB_NAME, DB_USER, DB_PASSWORD ou DB_HOST não batem com o banco)
Servidor MySQL/MariaDB fora do ar, reiniciando ou com excesso de carga
DB_HOST incorreto (o provedor usa 127.0.0.1 ou um host dedicado, não 'localhost')
Tabela do núcleo do WordPress corrompida (marcada como crashed pelo MySQL)
Limite de conexões da hospedagem compartilhada atingido em pico de acessos

Como resolver

Confirme as credenciais do banco: abra o wp-config.php via FTP e compare DB_NAME, DB_USER, DB_PASSWORD e DB_HOST com os dados do painel da hospedagem. Uma senha trocada recentemente é a causa nº 1.
Verifique se o servidor de banco está no ar: entre no phpMyAdmin do painel. Se ele também não conectar, o problema é no servidor MySQL: contate o suporte da hospedagem.
Teste o DB_HOST correto: se 'localhost' não conecta, troque por '127.0.0.1' ou pelo host de banco informado pelo provedor (comum em hospedagem com banco em servidor separado).
Repare o banco de dados: se o erro citar tabelas indisponíveis, adicione define('WP_ALLOW_REPAIR', true); ao wp-config.php e acesse seudominio.com/wp-admin/maint/repair.php. Remova a linha depois de reparar.
Cheque o limite de conexões: se o erro só aparece em picos, peça ao host para revisar max_connections do MySQL ou avalie subir de plano.

PHP

// Credenciais do banco no wp-config.php (ajuste aos dados do seu painel)
define( 'DB_NAME', 'nome_do_banco' );
define( 'DB_USER', 'usuario_do_banco' );
define( 'DB_PASSWORD', 'senha_do_banco' );
define( 'DB_HOST', 'localhost' ); // alguns provedores usam 127.0.0.1 ou um host dedicado

Perguntas frequentes

O erro aparece no site e no wp-admin ao mesmo tempo. Por quê?

Porque a conexão com o banco é a mesma para os dois. Se o WordPress não conecta ao MySQL, nada que dependa do banco carrega, nem o front-end nem o painel.

Conferi as credenciais e estão certas. E agora?

Provavelmente o servidor MySQL está fora do ar ou sobrecarregado. Teste o phpMyAdmin: se ele também não abrir, o problema é no servidor de banco e o suporte da hospedagem precisa agir.

Devo usar localhost ou 127.0.0.1 no DB_HOST?

Depende do provedor. Muitos usam 'localhost', mas hospedagens com banco em servidor separado exigem '127.0.0.1' ou um host específico. Teste os dois se não tiver certeza.

O que faz a linha WP_ALLOW_REPAIR?

Ela libera a rota /wp-admin/maint/repair.php para reparar e otimizar tabelas corrompidas sem login. Use só durante o reparo e remova depois, pois deixa a rota aberta.

Posso perder dados ao reparar o banco?

O WP_ALLOW_REPAIR repara e otimiza as tabelas sem apagar conteúdo. Mesmo assim, faça backup do banco antes: qualquer operação sobre uma tabela corrompida tem algum risco.

Mudei de hospedagem e deu esse erro. O que conferir primeiro?

Comece pelo DB_HOST: o novo provedor pode usar 127.0.0.1 ou um host de banco dedicado em vez de 'localhost'. Depois confira usuário e senha do banco no painel da nova hospedagem.

Pro Crítico

Como corrigir One or more database tables are unavailable

"One or more database tables are unavailable" significa que o MySQL marcou uma ou mais tabelas do WordPress como corrompidas e parou de respondê-las. O site fica fora do ar ou perde conteúdo até a tabela ser reparada.

Pro Atenção

Como corrigir erro de collation do banco de dados

O erro de collation do banco de dados no WordPress acontece quando tabelas ou colunas usam regras de ordenação diferentes e o MySQL recusa juntá-las, devolvendo "Illegal mix of collations". É comum após migrar o site entre servidores com versões de MySQL distintas.

Atenção

Como corrigir Deadlock found when trying to get lock

O erro Deadlock no MySQL do WordPress ocorre quando duas transações ficam presas esperando uma pela liberação do lock que a outra segura, e o InnoDB aborta uma delas para destravar. No WordPress costuma vir de plugins que gravam no banco em paralelo, de cron pesado ou de picos de escrita simultânea na mesma tabela.

Pro Atenção

Como corrigir prefixo de tabela duplicado após migração

O prefixo de tabela duplicado no WordPress acontece quando uma migração cria tabelas com um prefixo repetido, como wp_wp_, ou quando o $table_prefix do wp-config.php deixa de bater com o banco. O site perde acesso aos dados porque procura as tabelas com o nome errado, e até a wp_options e a wp_usermeta guardam o prefixo internamente.

Pro Grave

Como corrigir tabela wp_posts corrompida

A tabela de posts corrompida no WordPress acontece quando os arquivos da tabela que guarda posts e páginas ficam inconsistentes no MySQL. O conteúdo some ou não salva e o banco devolve "table is marked as crashed". O reparo reconstrói a tabela sem apagar o conteúdo.

Pro Grave

Como corrigir MySQL server has gone away

"MySQL server has gone away" aparece quando a conexão entre o WordPress e o MySQL cai antes da query terminar, geralmente por timeout de conexão ociosa ou por um pacote maior que o max_allowed_packet do servidor.

Setores

Extensões

Integrações

Como corrigir Error establishing a database connection

O que é o erro de conexão com o banco de dados?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir One or more database tables are unavailable

Como corrigir erro de collation do banco de dados

Como corrigir Deadlock found when trying to get lock

Como corrigir prefixo de tabela duplicado após migração

Como corrigir tabela wp_posts corrompida

Como corrigir MySQL server has gone away

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos