// 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 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。