Erro ao estabelecer uma conexão com o banco de dados
Um roteiro para quem não é técnico: as cinco causas em ordem de checagem, o que você confere sozinho no cPanel e a frase pronta para mandar ao suporte em cada caso.

Resposta curta: são cinco causas, nesta ordem: servidor de banco fora do ar, nome ou senha errados no wp-config.php, usuário sem permissão no banco, banco que não existe mais e tabela corrompida. Todas você confere no cPanel sem comandos, e cada uma tem um pedido certo ao suporte.
Neste artigo
O que a mensagem significa para o seu negócio
Quando o site mostra "Erro ao estabelecer uma conexão com o banco de dados" (ou, em inglês, *Error establishing a database connection*), o WordPress não conseguiu abrir o lugar onde guarda tudo o que importa: páginas, produtos, pedidos, cadastros de clientes. O visual do site fica em arquivos. O conteúdo fica no banco de dados. Sem banco, a página inteira some e o visitante vê só essa frase.
Na prática, enquanto a mensagem estiver no ar, ninguém compra, ninguém preenche formulário e o Google pode encontrar a página quebrada ao passar pelo site. Cada hora conta.
A boa notícia: a mensagem é genérica, mas as causas são poucas. São cinco, e existe uma ordem que poupa tempo, porque as primeiras são as mais rápidas de descartar. Este guia leva você por elas sem exigir conhecimento técnico nem comandos. Para cada causa você vai saber o que olhar sozinho no painel e o que pedir ao suporte ou ao desenvolvedor.
Antes de começar: o que você precisa ter em mãos
- Acesso ao cPanel, o painel da sua hospedagem. Se quem fez o site guardou esse acesso, peça agora.
- O endereço exato onde o erro aparece: só na página inicial, também no
/wp-admin(a área de administração), ou nos dois. - O que mudou recentemente: troca de senha, mudança de hospedagem, atualização de plugin, site que ficou fora do ar sem motivo.
Você não precisa de acesso de administrador do servidor (o chamado *root*). Tudo aqui se faz pelo cPanel ou por um chamado bem escrito.
Uma observação de vocabulário. MySQL (ou MariaDB) é o programa que guarda o banco de dados. O wp-config.php é o arquivo do WordPress onde ficam anotados o nome do banco, o usuário e a senha que o site usa para entrar nele. Se uma dessas três informações estiver errada, a porta não abre.
Em que ordem checar as cinco causas
| Ordem | Causa | Sinal típico | O que você confere | O que pedir |
|---|---|---|---|---|
| 1 | Servidor de banco fora do ar ou sobrecarregado | Erro surgiu do nada, sem ninguém mexer; outros sites da mesma conta também caíram | Se o phpMyAdmin abre no cPanel | Verificação do serviço MySQL |
| 2 | Dados errados no wp-config.php | Erro começou logo após troca de senha ou edição de arquivos | Nome do banco e do usuário no cPanel | Comparação com o wp-config.php |
| 3 | Usuário sem permissão no banco | Senha confere, mas o erro continua (às vezes aparece "Erro 1044") | Se o usuário está ligado ao banco | Ajuste de privilégios |
| 4 | Banco não existe com aquele nome | Erro começou depois de migração ou troca de hospedagem | Lista de bancos no cPanel | Restauração ou correção do nome |
| 5 | Tabelas corrompidas | No /wp-admin aparece aviso de que tabelas estão indisponíveis e precisam de reparo |
Ferramenta de reparo do cPanel | Reparo e, se falhar, restauração de backup |
Siga na ordem. Se uma etapa resolve, pare ali.
Como saber se o servidor de banco está fora do ar
É a causa que menos depende de você. Se o programa que guarda o banco parou ou está sobrecarregado, nenhuma senha certa adianta.
O que conferir sozinho: no cPanel, procure o ícone phpMyAdmin e clique. Se ele abrir e mostrar a lista de bancos à esquerda, o servidor de banco está funcionando. Se der erro ou ficar carregando sem fim, o problema provavelmente é do servidor. Se você tem mais de um site na mesma conta e todos mostram a mesma mensagem ao mesmo tempo, o sinal fica mais forte.
O que pedir ao suporte:
Como saber se os dados do wp-config.php estão errados
O WordPress tenta entrar com o que está anotado no wp-config.php. Se alguém trocou a senha do banco no cPanel e não atualizou o arquivo, a entrada falha.
O que conferir sozinho: no cPanel, abra Bancos de dados MySQL (*MySQL Databases*). Anote o nome do banco e o nome do usuário exatamente como aparecem. A documentação do cPanel explica que, em muitos servidores, esses nomes levam o nome da conta como prefixo, seguido de sublinhado (algo como suaconta_wp, exemplo fictício). Um prefixo faltando no arquivo já basta para o erro.
Agora veja o que está anotado no arquivo, só para ler, sem alterar nada:
- No cPanel, abra o Gerenciador de Arquivos (*File Manager*).
- Entre na pasta do site, geralmente public_html.
- Clique uma vez em wp-config.php e escolha Visualizar (*View*). Evite o botão Editar: um caractere apagado por engano derruba o site.
- Procure as linhas com DB_NAME (nome do banco) e DB_USER (usuário). O valor fica entre aspas logo depois.
Resultado esperado: os dois nomes do arquivo são idênticos aos que você anotou, letra por letra, com prefixo e sublinhado. Se algum for diferente, você achou a causa.
A senha você não consegue ver no painel, só trocar. Se a suspeita é senha, na mesma tela Bancos de dados MySQL, em Usuários atuais (*Current Users*), clique em Alterar senha (*Change Password*) ao lado do usuário do site e defina uma nova. Logo em seguida, a mesma senha precisa ser colocada no DB_PASSWORD do wp-config.php. Se você não quer editar o arquivo, faça só a troca no painel e mande a nova senha ao desenvolvedor por um canal seguro, sabendo que o site fica fora até ele atualizar o arquivo.
O que pedir ao desenvolvedor:
Como saber se o usuário não tem permissão no banco
Aqui a senha está certa, o banco existe, e mesmo assim o WordPress não entra. Isso acontece quando o usuário não foi associado ao banco ou perdeu os privilégios. Às vezes, em mensagens mais detalhadas, aparece o código Erro 1044 (acesso negado).
O que conferir sozinho: na mesma tela Bancos de dados MySQL, desça até a lista de bancos. Ao lado de cada banco aparecem os usuários ligados a ele. Se o usuário do site não está ali, essa é a causa.
Para ligar o usuário ao banco:
- Na tela Bancos de dados MySQL, desça até Adicionar usuário ao banco de dados (*Add User To Database*).
- Escolha o usuário do site e o banco do site nas duas listas e clique em Adicionar (*Add*).
- Na tela seguinte, marque Todos os privilégios (*ALL PRIVILEGES*) e clique em Fazer alterações (*Make Changes*).
Resultado esperado: o usuário passa a aparecer ao lado do banco na lista. Recarregue o site em seguida.
O que pedir ao suporte:
Como saber se o banco não existe com aquele nome
Comum depois de mudança de hospedagem. Os arquivos chegam, mas o banco não foi importado, ou foi criado com outro nome (o prefixo da nova conta costuma ser diferente do antigo).
O que conferir sozinho: em Bancos de dados MySQL, veja se o nome do banco que está no wp-config.php (a causa 2 mostra como abrir esse arquivo) aparece na lista. Há três situações possíveis:
- O banco não está na lista. Essa é a causa desta mensagem.
- O banco existe, mas está totalmente vazio (no phpMyAdmin, ao clicar nele, não aparece nenhuma tabela). Nesse caso o WordPress costuma mostrar a tela de instalação, aquela que pede para escolher o idioma e criar o site, e não este erro. Não preencha essa tela: ela cria um site novo, em branco.
- O banco existe com só parte das tabelas. A importação foi interrompida no meio, e o erro pode aparecer.
Se o banco não existe ou ficou incompleto, a solução é importar de novo a cópia vinda da hospedagem antiga. Peça essa cópia ao desenvolvedor que fez a mudança ou à hospedagem anterior, de preferência enquanto a conta antiga ainda estiver ativa.
O que pedir:
Como saber se as tabelas do banco estão corrompidas
Uma queda de energia no servidor, um disco cheio ou uma atualização interrompida pode danificar tabelas. O sinal mais claro aparece ao abrir o /wp-admin: o WordPress avisa que uma ou mais tabelas estão indisponíveis e que o banco pode precisar de reparo.
O que conferir sozinho: em Bancos de dados MySQL, a documentação do cPanel descreve as opções de verificar (*Check Database*) e reparar (*Repair Database*) um banco. Escolha o banco do site e rode a verificação primeiro. Se apontar problema, rode o reparo.
Se o reparo não resolver, não insista rodando várias vezes. O próximo passo é do suporte, que tem ferramentas de reparo no próprio servidor. Restaurar backup fica como última opção, porque apaga o que entrou no site depois da data da cópia.
O que pedir:
Quais erros evitar na hora de resolver
- Trocar a senha sem atualizar o arquivo. Resolve uma causa e cria outra. Troca de senha e edição do wp-config.php andam juntas.
- Restaurar backup antes de diagnosticar. Se o problema era o servidor (causa 1), o backup não ajuda e você pode perder pedidos e cadastros feitos desde a data dele.
- Instalar plugin de reparo. Com o banco fora, o WordPress nem carrega. Plugins não alcançam o problema.
- Abrir chamado só com "o site caiu". Mande a frase exata do erro, o horário, se o phpMyAdmin abre e o que mudou recentemente. Isso evita idas e vindas.
Como confirmar que o site voltou ao normal
Abra o site em uma janela anônima do navegador, para não ver uma versão guardada no seu computador. Confira a página inicial, uma página interna e o /wp-admin. Se for loja, faça um pedido de teste ou peça ao desenvolvedor que confirme que os pedidos do período em que o site esteve fora não se perderam.
Se o erro volta sozinho de tempos em tempos, sem ninguém mexer, a causa quase sempre é a 1. Nesse caso, peça ao suporte o histórico de quedas do serviço de banco na sua conta. Mudar de plano só faz sentido depois que essa resposta mostrar que o limite de recursos é o problema.
Fonte consultada
As telas e funções do cPanel citadas (Bancos de dados MySQL, phpMyAdmin, prefixo de nomes, verificação e reparo) seguem a SQL Knowledge Base do cPanel, consultada em 13/11/2026. Nomes de banco e usuário usados aqui são exemplos fictícios. Os nomes dos menus podem variar levemente conforme a versão e o idioma do painel da sua hospedagem.
Referências
- Documentação oficial (cpanel) — SQL Knowledge Base (cPanel). Consultado em 2026-11-13.