// 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 (或使用 SSL,若規則為 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。