# password authentication failed com a senha certa no PostgreSQL

Como ler a mensagem literal, montar o nome de usuário com prefixo, escolher o host certo e validar a conexão com psql antes de voltar ao arquivo de configuração.

> a causa mais fácil de descartar primeiro é o usuário informado sem o prefixo da conta cPanel. O PostgreSQL grava o usuário como `conta_usuario`, e conectar como `usuario` devolve exatamente o erro de senha, mesmo com a senha certa. Confirme o nome completo, o host e teste com `psql` antes de mexer na aplicação.

João Rizzon · 2026-10-07 · Painéis

---

## O que a mensagem de erro já entrega antes de você trocar a senha

O PostgreSQL devolve uma linha só, e ela diz mais do que parece:

```
psql: error: connection to server at "localhost" (127.0.0.1), port 5432 failed:
FATAL:  password authentication failed for user "loja"
```

Três informações saem daí de graça:

- **o host e a porta que o cliente realmente tentou** (`localhost`, `127.0.0.1`, `5432`);
- **o nome exato do usuário que chegou ao servidor** (`loja`);
- **o método**: o servidor pediu senha e rejeitou. Ou seja, chegou até a autenticação.

No exemplo acima o problema já está visível: em uma conta cPanel, o usuário quase nunca se chama `loja`. Ele se chama `conta_loja`. O servidor não rejeitou sua senha, ele rejeitou um usuário que não é o seu.

Se a mensagem for outra, o caminho é outro. Vale separar:

| Mensagem | O que ela indica | Onde olhar |
|---|---|---||
| `password authentication failed for user "x"` | Usuário chegou, senha não bateu (ou o usuário nem existe) | Nome com prefixo, senha, privilégio |
| `no pg_hba.conf entry for host "203.0.113.10"` | O servidor não aceita conexão desse IP | Liberação de IP remoto |
| `connection refused` / `could not connect to server` | Nada respondeu na porta | Host errado, porta errada, firewall |
| `database "x" does not exist` | Autenticou, mas o nome do banco está errado | Nome do banco com prefixo |

Trocar a senha quando a mensagem é `no pg_hba.conf entry` não resolve nada. Por isso a leitura vem antes.

## O prefixo da conta cPanel no nome do usuário e do banco

Em hospedagem compartilhada com cPanel, todo banco e todo usuário recebem o prefixo da conta cPanel seguido de underline. Se a conta é `napoleon`, o usuário que você criou como `loja` existe no PostgreSQL como `napoleon_loja`, e o banco criado como `catalogo` existe como `napoleon_catalogo`.

Isso derruba uma classe inteira de erro: o desenvolvedor copia o `DATABASES` de um projeto que rodava no notebook, onde o usuário era só `loja`, e cola no servidor.

Para conferir sem adivinhar, entre no cPanel e abra **Bancos de Dados → PostgreSQL Databases**. A tela lista os bancos existentes e os usuários atuais com o nome completo, já com prefixo. Copie dali, não digite de memória.

Um detalhe que passa batido: o nome completo tem limite de tamanho. Se você criou `usuario_muito_descritivo`, o nome gravado pode ter sido truncado. A lista da interface mostra o nome que existe de fato no banco. É esse que vai no arquivo de configuração.

## Quando localhost é o host errado e o que usar no lugar

O host correto depende de onde o código roda.

- **Aplicação na mesma hospedagem** (um PHP, um script Python no mesmo servidor): use `localhost` ou `127.0.0.1`. É o caminho local, não passa pela rede externa.
- **Aplicação fora** (Django em um VPS, Odoo na sua máquina, um cliente gráfico de banco no seu notebook): o host é o nome do servidor ou o IP dele, e a conexão só funciona se o seu IP de origem estiver autorizado.

No cPanel, a autorização de IPs para bancos fica na área de bancos de dados, na ferramenta de acesso remoto (**Remote Database Access**, em algumas versões apresentada por tipo de banco). Você adiciona o IP público da máquina que vai conectar. Para descobrir o IP público da máquina de onde você está, qualquer serviço de "meu IP" resolve, ou:

```
curl -s https://ifconfig.me
```

Se a sua internet é residencial com IP dinâmico, o IP muda e a liberação de ontem não vale hoje. Esse é um motivo comum de "funcionava e parou".

Quando a conexão vem de fora e o servidor só aceita autenticação local, a mensagem costuma ser a do `pg_hba.conf`, não a de senha. Mas em algumas configurações o cliente cai em um método que pede senha e falha mesmo assim. Por isso vale testar o host antes de concluir que a senha está errada.

## A tela do cPanel que realmente grava a senha no PostgreSQL

Este é o ponto em que mais gente se perde: nem toda tela com a palavra "senha" altera a senha do usuário do PostgreSQL. Trocar a senha de login do cPanel, por exemplo, não é a mesma coisa que trocar a senha do usuário do banco.

A [documentação do cPanel sobre falhas de autenticação no PostgreSQL](https://docs.cpanel.net/knowledge-base/sql/how-to-resolve-password-authentication-failed-errors-in-postgresql/) descreve o procedimento pela interface própria de PostgreSQL: abrir **PostgreSQL Databases**, localizar o usuário na lista **Current Users** e definir ali uma nova senha para ele. É esse campo que grava a senha no banco. Na mesma página, a documentação lembra que o nome do usuário aparece com o prefixo da conta cPanel e que é esse nome completo que deve ser usado na conexão.

### Guarde o arquivo de configuração atual antes de trocar a senha

Trocar a senha do usuário do banco derruba toda aplicação que usa aquele usuário até você atualizar o arquivo de configuração. Se for um site em produção, faça em horário de baixo movimento e tenha à mão o arquivo de configuração atual (`settings.py` no Django, `odoo.conf` no Odoo, ou o `.env` do projeto). O `wp-config.php` do WordPress não entra nessa lista: a instalação padrão do WordPress conecta em MySQL/MariaDB, e só guarda credencial de PostgreSQL se você tiver instalado um plugin ou driver específico para isso. Guarde uma cópia antes de editar. Voltar atrás é restaurar esse arquivo e colocar a senha nova nele.

### Onde fica a lista Current Users no cPanel

No cPanel, **Bancos de Dados → PostgreSQL Databases**. Role até a lista **Current Users**. Ao lado do usuário, use a opção de alterar senha (em algumas versões aparece como ícone de edição ou link **Change Password**).

### Senha sem @, : ou / para não quebrar a URL de conexão

Senha com `@`, `:`, `/`, `#`, `%` ou aspas quebra URL de conexão do tipo `postgres://usuario:senha@host/banco`, porque esses caracteres têm significado na própria URL. Para um primeiro teste, gere uma senha longa só com letras e números. Se funcionar, você já sabe que o problema era o caractere, e aí decide se codifica o caractere ou mantém a senha simples e longa.

### Verifique se o usuário está vinculado ao banco da aplicação

Ainda na mesma tela, na seção que associa usuário e banco, verifique se o usuário aparece vinculado ao banco que a aplicação usa. Senha certa em usuário sem vínculo gera erro, só que normalmente um erro de permissão, não de senha. Conferir custa dez segundos.

## Teste com psql ou pgAdmin antes de tocar na aplicação

Nunca volte direto para o arquivo de configuração. Teste antes, isolado, com um cliente burro.

Há dois caminhos para fazer esse teste, e você só precisa de um deles.

**Caminho 1: linha de comando.** No cPanel, procure na área **Avançado** o item **Terminal**, que abre um shell no próprio servidor dentro do navegador. Se o ícone não aparecer, o provedor pode não tê-lo habilitado; nesse caso, veja **Avançado → Acesso SSH**, onde ficam as chaves SSH para conectar de fora com um cliente como PuTTY ou o terminal do seu computador. Se nenhum dos dois estiver disponível no seu plano, pule para o caminho 2.

**Caminho 2: cliente gráfico de banco.** Instale no seu computador um cliente como pgAdmin ou DBeaver e crie uma conexão preenchendo quatro campos: host (o endereço do servidor informado pela hospedagem), porta (`5432`), usuário (o nome completo com prefixo) e senha (a que você acabou de definir). Como essa conexão vem de fora, o IP público da sua máquina precisa estar liberado no acesso remoto, conforme a seção anterior. O resultado esperado é a lista de bancos aparecer na lateral do programa. As mensagens de erro são as mesmas da tabela abaixo.

Se você tem acesso SSH no servidor:

```
psql -h localhost -U napoleon_loja -d napoleon_catalogo
```

Linha a linha: `-h` é o host, `-U` é o usuário completo com prefixo, `-d` é o banco completo com prefixo. O comando vai pedir a senha. O resultado esperado é o prompt do PostgreSQL, algo como `napoleon_catalogo=>`. Para sair, digite `\q` e Enter.

Se você está fora do servidor, troque o host:

```
psql -h servidor.exemplo.com.br -p 5432 -U napoleon_loja -d napoleon_catalogo
```

O nome de host acima é um exemplo fictício: use o host que a sua hospedagem informa.

Resultados possíveis e o que cada um significa:

| Saída do `psql` | Interpretação | Próximo passo |
|---|---|---||
| Prompt `banco=>` | Credencial e host corretos | O erro está no arquivo de configuração da aplicação |
| `password authentication failed` | Usuário ou senha ainda não batem | Reveja prefixo e refaça a senha sem caractere especial |
| `no pg_hba.conf entry for host` | Origem não autorizada | Libere o IP no acesso remoto |
| `connection refused` | Nada escutando nesse host/porta | Host ou porta errados, ou bloqueio de rede |

Se o `psql` entra e a aplicação não, o servidor está certo. O problema passou a ser string de conexão, variável de ambiente antiga em cache ou um segundo arquivo de configuração que você esqueceu.

## Atualize a configuração e reinicie o processo, senão a senha velha continua em memória

Com a conexão validada, atualize a configuração. Em Django, o bloco fica assim (valores de exemplo):

```python
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": "napoleon_catalogo",
        "USER": "napoleon_loja",
        "PASSWORD": "senha_definida_no_cpanel",
        "HOST": "localhost",
        "PORT": "5432",
    }
}
```

Em Odoo, os campos equivalentes no `odoo.conf` são `db_host`, `db_port`, `db_user` e `db_password`, com os mesmos valores completos e com prefixo.

Depois de salvar, reinicie o processo da aplicação. Django com Gunicorn, Odoo como serviço, PHP-FPM em alguns casos: enquanto o processo antigo estiver no ar, ele continua usando a senha velha em memória e você vai achar que a correção não pegou.

Se a aplicação lê a senha de uma variável de ambiente, confira se não existe um `.env` antigo sobrescrevendo o novo valor. Dois arquivos com a mesma variável é uma das causas mais chatas de "já troquei e continua igual".

## Ordem de verificação, do erro literal ao chamado na hospedagem

Na ordem, sem pular:

- Copie a mensagem de erro inteira e identifique se ela fala de senha, de `pg_hba.conf` ou de conexão recusada.
- Abra **PostgreSQL Databases** no cPanel e copie o nome completo do banco e do usuário, com prefixo.
- Defina o host pela localização do código: `localhost` se roda no mesmo servidor, host externo com IP liberado se roda fora.
- Guarde uma cópia do arquivo de configuração atual.
- Redefina a senha do usuário do banco pela interface de PostgreSQL do cPanel, com senha longa sem caractere especial.
- Teste a conexão fora da aplicação, com `psql` ou com um cliente gráfico (pgAdmin, DBeaver), antes de tocar no arquivo de configuração.
- Atualize a configuração, reinicie o processo, confirme que não há arquivo de ambiente duplicado.

Se depois disso o teste externo conectar e a aplicação não, o problema deixou de ser do banco. Se nem o `psql` nem o cliente gráfico conectarem com o nome prefixado e a senha recém-definida, aí sim vale abrir chamado com a hospedagem, mandando a mensagem literal do erro, o host testado e o nome completo do usuário. Esses três dados economizam uma rodada inteira de perguntas.

