Como corrigir Error establishing a database connection
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.
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.
// 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 dedicadoPerguntas frequentes
O erro aparece no site e no wp-admin ao mesmo tempo. Por quê?
Conferi as credenciais e estão certas. E agora?
Devo usar localhost ou 127.0.0.1 no DB_HOST?
O que faz a linha WP_ALLOW_REPAIR?
Posso perder dados ao reparar o banco?
Mudei de hospedagem e deu esse erro. O que conferir primeiro?
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.
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.
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.
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.
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.
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.
