// Referência de erro do PostgreSQL

PostgreSQL 28P01: falha na autenticação da senha

PostgreSQL rejeitou a senha deste usuário. Pode ser uma senha errada, um papel sem senha ou uma senha com hash em um formato que o servidor não aceita mais.

SQLSTATE
28P01
Nome
invalid_password
Categoria
Especificação de autorização inválida
Mensagem de erro
password authentication failed for user "app"

O que significa

O servidor encontrou um pg_hba.conf regra que solicita uma senha (scram-sha-256, md5 ou password) para esta conexão, e a senha que o cliente enviou não corresponde à senha armazenada da função.

Por segurança, o cliente recebe apenas a informação de que a senha falhou. O log do servidor contém o motivo, por exemplo User "app" has no password assigned ou Role "app" does not exist.

Causas comuns

  • Senha incorreta, ou uma senha com caracteres especiais corrompida em uma URL de conexão (eles devem ser codificados em porcentagem).
  • O papel não existe ou não tem senha definida; o cliente ainda vê password authentication failed.
  • A senha do papel está armazenada como um hash MD5, mas pg_hba.conf exige scram-sha-256, depois de uma atualização para o padrão SCRAM.
  • O cliente pegou uma senha diferente de PGPASSWORD ou um .pgpass arquivo.

Como corrigir

  1. Leia a entrada do log do servidor para o login que falhou; ela informa o motivo real.

  2. Defina uma nova senha como superusuário (no psql, \password app solicita a senha sem exibi-la).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. Verifique como a senha é armazenada. Um valor que começa com md5 deve ser redefinido após a troca password_encryption para scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. Verifique qual pg_hba.conf linha correspondeu; a visão mostra o arquivo como o servidor o carregou.

    SELECT line_number, type, database, user_name, address, auth_method
    FROM pg_hba_file_rules;
  5. Codifique caracteres especiais em URLs de conexão usando percent-encoding, por exemplo @ como %40: postgresql://app:p%40ss@db:5432/shop.

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.