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

Tipo Banco de dados

Nome do erro Erro de conexão com o banco de dados EN: 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

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.

Crítico

Como reparar tabelas corrompidas no WordPress

Reparar tabelas corrompidas no WordPress é o processo de consertar tabelas do banco MySQL/MariaDB que ficaram danificadas e pararam de responder. A corrupção costuma vir de queda de energia, disco cheio ou MySQL desligado no meio de uma escrita, e gera erros como "table is marked as crashed" e tabelas indisponíveis.

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.

Grave

Como corrigir Table doesn’t exist após migração

O erro Table doesn't exist no WordPress aparece quando o site procura uma tabela do banco que não existe com aquele nome, quase sempre após uma migração. A causa típica é o prefixo de tabela do wp-config.php não bater com o prefixo real das tabelas importadas, ou um dump exportado de forma incompleta.

Grave

Como limpar a tabela wp_options inchada (autoload)

A tabela de opções incha quando plugins gravam muitos dados com autoload = yes, que o WordPress carrega em toda página. Isso deixa o site lento e pesa no banco. A correção é medir o autoload e desligar ou apagar as opções que não precisam ser carregadas sempre.

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.

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.

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

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como reparar tabelas corrompidas no WordPress

Como corrigir erro de collation do banco de dados

Como corrigir Table doesn’t exist após migração

Como limpar a tabela wp_options inchada (autoload)

Como corrigir One or more database tables are unavailable

Como corrigir Deadlock found when trying to get lock

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