// PostgreSQL 错误参考

PostgreSQL 28000:无效的授权规范

服务器在检查密码之前拒绝登录:没有匹配的 pg_hba.conf 规则、角色不存在或无法登录。

SQLSTATE
28000
名称
invalid_authorization_specification
类别
无效的授权规范
错误信息
no pg_hba.conf entry for host "10.0.0.5", user "app", database "shop", no encryption

它的意思

28000 涵盖密码错误(28P01)以外的登录失败。最常见的是 no pg_hba.conf entry:服务器的基于主机的身份验证文件中,没有任何一行能匹配此客户端的地址、用户、数据库和加密方式。其他出现此代码的情况包括 role "app" does not exist 和 role "app" is not permitted to log in (角色缺少 LOGIN 属性之间从不加空格。

消息准确列出了服务器看到的内容,这正是你需要在 pg_hba.conf中匹配的。最后一部分说明连接是否经过加密:类型为 hostssl 仅匹配 SSL 连接。

常见原因

  • 从新的 IP 地址或网络连接,而没有任何 pg_hba.conf 行涵盖的内容。
  • 客户端未使用 SSL 连接,但唯一匹配的规则是 hostssl (或在规则为 hostnossl).
  • 某条规则列出的具体用户或数据库不包括当前这一项。
  • 该角色在此服务器上不存在,或者创建时使用了 CREATE ROLE (默认为 NOLOGIN创建的(默认为 CREATE USER.

如何修复它

  1. 添加一个 pg_hba.conf 为客户端加一行,置于任何更宽泛的 reject 一行,然后重新加载。例如 hostssl shop app 10.0.0.0/24 scram-sha-256.

    SELECT pg_reload_conf();
    SELECT line_number, type, database, user_name, address, auth_method, error
    FROM pg_hba_file_rules;
  2. 允许角色登录,或创建该角色。

    ALTER ROLE app WITH LOGIN;
    CREATE ROLE app WITH LOGIN PASSWORD 'strong-password';
  3. 确保服务器在网络上监听(listen_addresses),并让客户端在规则要求时使用 SSL,例如 sslmode=require.

相关错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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