blog
WordPress

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.

JR · · 9 min de leitura · 1 tabela

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
  1. O que a mensagem significa para o seu negócio
  2. Antes de começar: o que você precisa ter em mãos
  3. Em que ordem checar as cinco causas
  4. Quais erros evitar na hora de resolver
  5. Como confirmar que o site voltou ao normal
  6. Fonte consultada

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

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:

  1. No cPanel, abra o Gerenciador de Arquivos (*File Manager*).
  2. Entre na pasta do site, geralmente public_html.
  3. Clique uma vez em wp-config.php e escolha Visualizar (*View*). Evite o botão Editar: um caractere apagado por engano derruba o site.
  4. 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:

  1. Na tela Bancos de dados MySQL, desça até Adicionar usuário ao banco de dados (*Add User To Database*).
  2. Escolha o usuário do site e o banco do site nas duas listas e clique em Adicionar (*Add*).
  3. 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:

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:

Ordem para checar as causasServidor de banco fora do arphpMyAdmin não abreDados errados no wp-config.phpNome ou senha não batemUsuário sem permissão no bancoUsuário não ligado ao bancoBanco com nome diferenteBanco ausente ou incompletoTabelas corrompidasAviso no /wp-admin pede reparo
Siga de cima para baixo. Se uma etapa resolve, pare ali.

Quais erros evitar na hora de resolver

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

  1. Documentação oficial (cpanel) — SQL Knowledge Base (cPanel). Consultado em 2026-11-13.
Leia também