// справочник ошибок PostgreSQL

PostgreSQL 28P01: сбой аутентификации по паролю

PostgreSQL отклонил пароль для этого пользователя. Неверный пароль, роль без пароля или пароль, захэшированный в формате, который сервер больше не принимает.

SQLSTATE
28P01
Имя
invalid_password
Категория
Недопустимая спецификация авторизации
Сообщение об ошибке
password authentication failed for user "app"

Что это значит

Сервер обнаружил pg_hba.conf правило, которое запрашивает пароль (scram-sha-256, md5 или password) для этого подключения, и пароль, отправленный клиентом, не совпал с сохранённым паролем роли.

В целях безопасности клиенту сообщается только, что пароль неверен. В журнале сервера указана причина, например User "app" has no password assigned или Role "app" does not exist.

Распространённые причины

  • Неверный пароль или пароль со специальными символами, искажённый в URL подключения (символы должны быть закодированы процентным кодированием).
  • Роль не существует или у неё не установлен пароль; клиент всё равно видит password authentication failed.
  • Пароль роли сохранён как хэш MD5, но pg_hba.conf требуется scram-sha-256, после обновления, где SCRAM стал значением по умолчанию.
  • Клиент получил другой пароль из PGPASSWORD или .pgpass файл.

Как исправить

  1. Прочитайте запись журнала сервера о неудачном входе; в ней указана реальная причина.

  2. Установите новый пароль как суперпользователь (в psql, \password app подсказки не отображают ввод).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. Проверьте, как хранится пароль. Значение, начинающееся с md5 должно быть сброшено после переключения password_encryption в scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. Проверьте, какая pg_hba.conf строка совпала; представление показывает файл таким, каким сервер его загрузил.

    SELECT line_number, type, database, user_name, address, auth_method
    FROM pg_hba_file_rules;
  5. Процентное кодирование специальных символов в URL подключений, например @ как %40: postgresql://app:p%40ss@db:5432/shop.

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.