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