blog
Painéis

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.

JR · · 9 min de leitura · 2 tabelas · 5 blocos de código

Resposta curta: 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.

Neste artigo
  1. O que a mensagem de erro já entrega antes de você trocar a senha
  2. O prefixo da conta cPanel no nome do usuário e do banco
  3. Quando localhost é o host errado e o que usar no lugar
  4. A tela do cPanel que realmente grava a senha no PostgreSQL
  5. Teste com psql ou pgAdmin antes de tocar na aplicação
  6. Atualize a configuração e reinicie o processo, senão a senha velha continua em memória
  7. Ordem de verificação, do erro literal ao chamado na hospedagem

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:

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.

Triagem pela mensagem literal do PostgreSQLpassword authentication failedRevise prefixo e senhano pg_hba.conf entryLibere o IP remotoconnection refusedHost, porta ou firewalldatabase does not existNome do banco com prefixo
Cada mensagem aponta para um lugar diferente. Leia antes de trocar a senha.

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.

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 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):

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

Da senha nova até a aplicação conectarCopiar nome com prefixoTela PostgreSQL DatabasesRedefinir senhaSó letras e númerosTestar fora da aplicaçãopsql, pgAdmin ou DBeaverAtualizar configuraçãoGuarde cópia do arquivoReiniciar o processoSenha velha fica em memória
Sem reiniciar o processo, a aplicação continua usando a credencial antiga.

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

Na ordem, sem pular:

  1. Copie a mensagem de erro inteira e identifique se ela fala de senha, de pg_hba.conf ou de conexão recusada.
  2. Abra PostgreSQL Databases no cPanel e copie o nome completo do banco e do usuário, com prefixo.
  3. Defina o host pela localização do código: localhost se roda no mesmo servidor, host externo com IP liberado se roda fora.
  4. Guarde uma cópia do arquivo de configuração atual.
  5. Redefina a senha do usuário do banco pela interface de PostgreSQL do cPanel, com senha longa sem caractere especial.
  6. 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.
  7. 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.

Referências

  1. Documentação oficial (cpanel) — How to Resolve Password Authentication Failed Errors in PostgreSQL. Consultado em 2026-10-06.
Leia também