blog
WordPress

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.

JR · · 10 min de leitura · 2 tabelas · 2 blocos de código

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
  1. A mensagem é uma só, as causas são quatro
  2. Ver o erro real do MySQL sem instalar plugin
  3. Traduzir o código do erro em decisão
  4. Conferir no cPanel se o usuário ainda aparece vinculado
  5. Reassociar o usuário ao banco com ALL PRIVILEGES
  6. Quando o problema é a senha, mesmo parecendo certa
  7. Por que restaurar backup é a pior primeira resposta
  8. 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 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.

Do codigo do erro ate a acao corretaRodar o testedb.phpLeia o codigo numerico do erroErro 1044Privilegio perdido: reassociar no cPanelErro 1045Identidade: senha ou usuario ausenteErro 1049Nome do banco errado no arquivoErro 2002Servico de banco fora do arConexao OKProblema esta fora da conexao
Cada resposta do teste aponta para uma acao diferente.

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:

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.

  1. Em Usuário, escolha o nome que está em DB_USER.
  2. Em Banco de dados, escolha o nome que está em DB_NAME.
  3. 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:

  1. Digite o nome de usuário idêntico ao que está no wp-config.php, sem o prefixo (o cPanel adiciona sozinho).
  2. 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 no wp-config.php.
  3. 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:

  1. ler o erro real (arquivo de teste ou debug.log);
  2. conferir a vinculação usuário/banco no cPanel;
  3. reassociar com ALL PRIVILEGES;
  4. redefinir a senha e atualizar o wp-config.php;
  5. só então, se nada disso resolveu e o erro aponta para dados, pensar em reparo de tabelas ou backup.
Ordem segura de intervencao no bancoDiagnosticarLer o erro real antes de agirConferir vinculoUsuarios privilegiados na linha do bancoAcao reversivelALL PRIVILEGES e nova senhaAcao destrutivaBackup ou reparo, somente no fim
Restaurar backup e o ultimo passo, nao o primeiro.

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

  1. Documentação oficial (cpanel) — How to Restore a User Database Access (cPanel). Consultado em 2026-09-18.
Leia também