# 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.

> 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.

João Rizzon · 2026-09-19 · WordPress

---

## 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.php` ficou 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:

```php
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
<?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_USER` aparece 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](https://docs.cpanel.net/knowledge-base/sql/how-to-restore-a-user-database-access/).

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 no `wp-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.

