Erro 1044 no WordPress: conexão negada com a senha certa
Como ler o erro real do MySQL, conferir a vinculação usuário/banco na tela do cPanel e devolver os privilégios sem apagar nada.

Resposta curta: quatro situações diferentes produzem a mesma tela no WordPress. Quando as credenciais do wp-config estão certas, o erro real do MySQL costuma ser 1044: o usuário perdeu o privilégio sobre o banco. Dá para reassociar na tela do cPanel, sem restaurar backup.
Neste artigo
- A mensagem é uma só, as causas são quatro
- Ver o erro real do MySQL sem instalar plugin
- Traduzir o código do erro em decisão
- Conferir no cPanel se o usuário ainda aparece vinculado
- Reassociar o usuário ao banco com ALL PRIVILEGES
- Quando o problema é a senha, mesmo parecendo certa
- Por que restaurar backup é a pior primeira resposta
- Validar que voltou e o que checar se não voltou
A mensagem é uma só, as causas são quatro
A tela branca com "Erro ao estabelecer uma conexão com o banco de dados" é escrita pelo WordPress, não pelo MySQL. O WordPress tenta conectar, recebe uma recusa e imprime sempre o mesmo texto, seja qual for o motivo da recusa. É por isso que conferir o wp-config.php dez vezes não resolve: as credenciais podem estar corretas e a conexão continuar sendo negada.
Quatro situações diferentes produzem exatamente essa tela:
- o usuário existe e a senha está certa, mas ele não tem mais privilégio sobre aquele banco (o MySQL responde com o erro 1044);
- o banco existe, mas com outro nome (ou foi renomeado, ou o prefixo da conta mudou);
- a senha do usuário foi alterada no painel e o
wp-config.phpficou para trás, ou o usuário deixou de existir; - o serviço MySQL do servidor está fora do ar, e aí não há o que consertar no site.
O caso que este guia resolve é o primeiro, e ele é o mais frustrante porque tudo "parece certo". A associação entre usuário e banco é um registro separado no MySQL: apagar um usuário e recriar com o mesmo nome, restaurar um backup parcial ou mexer em privilégios pelo phpMyAdmin pode deixar o usuário vivo, com a senha correta, e sem nenhum direito sobre o banco do site.
Uma observação sobre a natureza deste conteúdo: não há medição de laboratório aqui. Este é um procedimento de painel, apoiado na documentação oficial do cPanel sobre como restaurar o acesso de um usuário a um banco de dados. Nada do que está abaixo foi cronometrado ou testado em bancada por nós, e não vamos fingir que foi.
Ver o erro real do MySQL sem instalar plugin
Antes de mexer em qualquer coisa, descubra qual dos quatro casos é o seu. Existem dois caminhos.
Ligar o log de depuração no wp-config.php
Risco primeiro: faça uma cópia do wp-config.php antes de editar. No Gerenciador de Arquivos do cPanel, clique com o botão direito no arquivo, escolha Copiar e salve como wp-config.php.bak. Se algo sair errado, você renomeia a cópia de volta e volta ao estado anterior. E desligue o debug quando terminar, porque o debug.log fica acessível pela web em instalações mal fechadas.
Feita a cópia, acesse o Gerenciador de Arquivos, entre em public_html (ou na pasta do site), clique com o botão direito em wp-config.php e escolha Editar. Antes da linha que diz /* That's all, stop editing! */, acrescente:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Salve e recarregue o site. Com WP_DEBUG_LOG ligado, o WordPress grava os avisos em wp-content/debug.log. Abra esse arquivo pelo Gerenciador de Arquivos e procure a linha do mysqli. Ela costuma trazer o texto original do banco.
Um arquivo de teste de dez linhas que mostra o código do erro
É o método mais direto, porque mostra o código numérico do erro. No Gerenciador de Arquivos, dentro de public_html, clique em + Arquivo, crie testedb.php e cole o conteúdo abaixo, trocando os quatro valores pelos que estão no seu wp-config.php:
<?php
$host = 'localhost'; // valor de DB_HOST
$user = 'conta_wpuser'; // valor de DB_USER
$pass = 'SenhaDoBanco'; // valor de DB_PASSWORD
$db = 'conta_wp'; // valor de DB_NAME
$conn = @new mysqli($host, $user, $pass, $db);
if ($conn->connect_errno) {
echo 'ERRO ' . $conn->connect_errno . ': ' . $conn->connect_error;
} else {
echo 'Conexao OK';
}
Os nomes conta_wpuser e conta_wp são exemplo fictício: no cPanel, banco e usuário sempre carregam o prefixo da sua conta.
Abra https://seusite.com.br/testedb.php no navegador. Você vai ler uma frase e só. Depois de anotar o resultado, apague o arquivo imediatamente: ele contém a senha do banco em texto puro e está público.
Traduzir o código do erro em decisão
| Resposta na tela | Código | O que está acontecendo | O que fazer |
|---|---|---|---|
Access denied for user 'conta_wpuser'@'localhost' to database 'conta_wp' |
1044 | O usuário existe e a senha foi aceita, mas ele não tem privilégio sobre esse banco. É a associação perdida | Reassociar usuário e banco no cPanel com ALL PRIVILEGES |
Access denied for user 'conta_wpuser'@'localhost' (using password: YES) |
1045 | A senha enviada não corresponde, ou o usuário não existe mais no MySQL | Conferir o DB_USER em Usuários atuais e redefinir a senha |
Access denied for user ... (using password: NO) |
1045 | O PHP enviou senha vazia. Normalmente o DB_PASSWORD está em branco ou a linha foi corrompida |
Corrigir a linha DB_PASSWORD no wp-config.php |
Unknown database 'conta_wp' |
1049 | O usuário conectou no servidor, mas o banco com esse nome não existe | Conferir o nome exato na tela Bancos de Dados MySQL e ajustar DB_NAME |
Can't connect to local MySQL server |
2002 | O serviço de banco não respondeu | Não é configuração do site. Falar com o suporte do servidor |
Conexao OK |
nenhum | Credencial e privilégio estão bons | O problema está em outro lugar: tabelas corrompidas, prefixo, plugin |
A diferença entre os dois primeiros códigos é o eixo do diagnóstico. O 1044 é privilégio: a identidade foi aceita e o acesso àquele banco, não. O 1045 é identidade: usuário inexistente ou senha divergente. Se a mesma operação que removeu o vínculo também apagou o usuário, o erro chega como 1045, e aí é preciso recriar o usuário antes de associar.
Essa tabela é o mapa do resto do artigo. O erro 1044 é o caso da associação perdida, e é o que a tela do cPanel resolve em poucos cliques, sem tocar nos dados.
Conferir no cPanel se o usuário ainda aparece vinculado
Entre no cPanel e procure, na busca do topo, por Bancos de Dados MySQL. Na versão Jupiter, o ícone fica na seção Bancos de Dados.
Role a página até Bancos de dados atuais. Você vai ver uma tabela com três colunas: o nome do banco, o tamanho e Usuários privilegiados.
Procure a linha cujo nome é exatamente igual ao valor de DB_NAME no seu wp-config.php. Compare caractere por caractere, inclusive o prefixo da conta. Agora olhe a coluna Usuários privilegiados nessa linha:
- se o nome do
DB_USERaparece ali, a associação existe. Nesse cenário o erro 1044 costuma indicar privilégio parcial, e o 1045 aponta para a senha; - se a coluna está vazia, ou lista outro usuário qualquer, é este o seu problema. O WordPress está batendo na porta com uma credencial válida de um usuário que não tem chave daquela sala.
Role um pouco mais até Usuários atuais. Confirme que o DB_USER do wp-config.php está na lista. Se o usuário sumiu por completo, o caminho muda um pouco e está descrito adiante.
Anote os dois nomes completos antes de continuar. Na próxima tela você vai precisar selecioná-los em menus suspensos, e contas com muitos bancos costumam ter nomes parecidos.
Reassociar o usuário ao banco com ALL PRIVILEGES
Este é o procedimento descrito na documentação oficial do cPanel sobre restaurar o acesso de um usuário a um banco de dados.
Antes de começar, o aviso de risco: conceder privilégio não apaga nada. Nenhum post, nenhuma configuração, nenhuma tabela é tocada. O que destrói dado é apagar o banco e recriar, ou restaurar um backup antigo por cima. Ainda assim, se você tem como exportar o banco pelo phpMyAdmin antes (aba Exportar, formato SQL, método Rápido), faça. É rápido e te dá um ponto de retorno.
Adicionar o usuário ao banco na tela Bancos de Dados MySQL
Na mesma tela Bancos de Dados MySQL, localize a seção Adicionar usuário ao banco de dados. São dois menus suspensos.
- Em Usuário, escolha o nome que está em
DB_USER. - Em Banco de dados, escolha o nome que está em
DB_NAME. - Clique em Adicionar.
Marcar ALL PRIVILEGES, porque privilégio parcial falha depois
O cPanel abre a tela Gerenciar privilégios de usuário, com uma lista de caixas de seleção (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, INDEX e outras).
Marque a caixa ALL PRIVILEGES, no topo. Ela seleciona todas as demais de uma vez. O WordPress precisa de mais do que leitura e escrita: atualização de versão e instalação de plugin criam e alteram tabelas, então privilégio parcial gera falhas intermitentes que são bem piores de diagnosticar do que a tela de erro de conexão.
Clique em Fazer alterações. Você volta para a tela anterior e, em Bancos de dados atuais, o nome do usuário agora aparece na coluna Usuários privilegiados.
Recriar o usuário quando ele não existe mais
Quando o DB_USER do wp-config.php não aparece em Usuários atuais, é preciso recriá-lo antes de associar. Esse é o cenário em que o teste devolve 1045 mesmo com a senha certa. Na seção Adicionar novo usuário:
- Digite o nome de usuário idêntico ao que está no
wp-config.php, sem o prefixo (o cPanel adiciona sozinho). - Em senha, você tem duas opções: repetir a senha que já está no
wp-config.php, se você a conhece, ou gerar uma nova e depois colá-la nowp-config.php. - Clique em Criar usuário e repita os passos 1 e 2 acima.
Recriar o usuário com o mesmo nome e a mesma senha evita qualquer edição de arquivo. É o caminho mais curto quando você tem a senha à mão.
Quando o problema é a senha, mesmo parecendo certa
Se a associação estava lá, o usuário aparece em Usuários atuais e o erro 1045 persiste, sobrou a senha. Três armadilhas comuns:
Aspas duplas no wp-config.php. Em PHP, "minha$senha" faz o interpretador tentar substituir $senha por uma variável, e o que chega ao MySQL é minha. Use sempre aspas simples: define( 'DB_PASSWORD', 'minha$senha' );.
Espaço colado no fim. Copiar a senha de um bloco de notas ou de um e-mail costuma trazer um espaço ou uma quebra de linha invisível junto. Apague o valor inteiro entre as aspas e digite de novo.
Senha trocada no painel e esquecida no arquivo. Acontece depois de um alerta de segurança ou de uma troca feita por outra pessoa da equipe.
O jeito de eliminar as três de uma vez é redefinir a senha. Em Bancos de Dados MySQL, seção Usuários atuais, clique em Alterar senha ao lado do usuário. Use o gerador do cPanel, copie o valor gerado para um lugar seguro e clique em Alterar senha. Depois abra o wp-config.php no Gerenciador de Arquivos e cole o mesmo valor entre aspas simples em DB_PASSWORD. Salve e recarregue o site.
Evite gerar senhas com aspas, barra invertida ou cifrão se você vai colar em arquivo PHP. Letras, números e alguns símbolos simples eliminam uma classe inteira de erro de escape.
Por que restaurar backup é a pior primeira resposta
A sugestão mais repetida na internet para essa tela é restaurar um backup do banco. Ela funciona em alguns casos e cobra um preço alto por isso.
Restaurar o banco devolve o site ao estado do dia do backup. Tudo que entrou depois some: posts, páginas editadas, comentários, pedidos de loja, cadastros de formulário, configurações de plugin. Se a causa era um privilégio removido, você perdeu conteúdo real para resolver um problema que não estava nos dados, e sim na permissão.
Pior ainda é apagar o banco para recriar. Na tela Bancos de Dados MySQL, o botão de excluir fica a um clique de distância dos botões que você vai usar neste procedimento. Um banco excluído não volta sem backup.
A ordem correta é sempre diagnóstico, depois ação reversível, depois ação destrutiva:
- ler o erro real (arquivo de teste ou
debug.log); - conferir a vinculação usuário/banco no cPanel;
- reassociar com ALL PRIVILEGES;
- redefinir a senha e atualizar o
wp-config.php; - só então, se nada disso resolveu e o erro aponta para dados, pensar em reparo de tabelas ou backup.
Validar que voltou e o que checar se não voltou
Recarregue a home do site. Depois entre em /wp-admin e abra Posts. Se a listagem carrega, a leitura e a escrita estão funcionando.
Vale um teste de escrita também: abra um post, clique em Atualizar e veja se a mensagem de salvamento aparece. Privilégio parcial deixa o site carregar e falha só na hora de gravar.
Se você criou o testedb.php, apague o arquivo agora. Se ligou o debug, remova as três linhas do wp-config.php e apague o wp-content/debug.log.
Quando o site volta mas as tabelas parecem inconsistentes (página branca no admin, aviso de tabela indisponível), o WordPress tem um recurso próprio de reparo: adicione define( 'WP_ALLOW_REPAIR', true ); ao wp-config.php e acesse https://seusite.com.br/wp-admin/maint/repair.php. A página funciona sem login, então remova a linha assim que terminar.
Ordem de descarte quando o erro continua
| Sintoma depois da reassociação | Causa mais provável | Próximo passo |
|---|---|---|
| Continua 1044 | Privilégio aplicado em outro banco, ou DB_NAME diferente do banco que você associou |
Reconferir a coluna Usuários privilegiados na linha exata do DB_NAME |
Continua 1045 com using password: YES |
Senha divergente ou usuário inexistente | Redefinir a senha no cPanel e colar no wp-config.php |
| Passou a dar 1049 | DB_NAME errado no arquivo |
Copiar o nome exato de Bancos de dados atuais |
Conexao OK no teste, erro no site |
O WordPress lê outro wp-config.php ou outro DB_HOST |
Confirmar a pasta correta do domínio e o valor de DB_HOST |
| Erro 2002 | Serviço de banco indisponível | Acionar o suporte do servidor, não há ajuste no site |
| Site carrega, admin falha ao salvar | Privilégio parcial | Voltar em Gerenciar privilégios e marcar ALL PRIVILEGES |
Sobre o DB_HOST: em hospedagem compartilhada com cPanel, o valor é localhost na quase totalidade dos casos. Se o seu wp-config.php traz um endereço IP ou um hostname externo, o banco é remoto e a conexão depende de o IP do servidor estar liberado em Acesso remoto MySQL, uma tela separada no painel. Trocar esse valor às cegas para localhost vai gerar o erro 1049 ou 2002, então só mexa se você souber que o banco é local.
Um último detalhe que economiza tempo: o $table_prefix do wp-config.php não causa erro de conexão. Prefixo errado produz uma tela diferente, a de instalação do WordPress ou um aviso de tabelas ausentes, porque a conexão foi aceita e só a consulta falhou. Se você caiu na tela de instalação depois de mexer no arquivo, não clique em nada: o problema é prefixo ou nome de banco, e prosseguir com a instalação sobrescreve dados.
Referências
- Documentação oficial (cpanel) — How to Restore a User Database Access (cPanel). Consultado em 2026-09-18.