// PostgreSQL 錯誤參考
PostgreSQL 28P01:密碼驗證失敗
PostgreSQL 拒絕了這位使用者的密碼。可能是密碼錯誤、角色沒有設定密碼,或密碼以伺服器不再接受的格式雜湊。
- SQLSTATE
28P01- 名稱
invalid_password- 類別
- 無效的授權規範
它的意義
伺服器找到了一個 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檔案旁邊。
如何修正
-
查看伺服器日誌中該次登入失敗的紀錄,上面會寫明真正的原因。
-
以超級使用者身分設定新密碼(在 psql 中,
\password app會提示輸入,但不顯示你輸入的內容)。ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
-
檢查密碼的儲存方式。若值開頭為
md5切換之後必須重設。password_encryption到scram-sha-256.SHOW password_encryption; SELECT rolname, left(rolpassword, 14) AS hash_type FROM pg_authid WHERE rolname = 'app';
-
檢查哪個
pg_hba.conf行相符;檢視顯示的是伺服器載入當下的檔案。SELECT line_number, type, database, user_name, address, auth_method FROM pg_hba_file_rules;
-
將連線 URL 中的特殊字元做百分比編碼,例如
@作為%40:postgresql://app:p%40ss@db:5432/shop.
相關錯誤
28000授權規格無效3D000資料庫不存在53300連線數過多18456SQL Server:使用者登入失敗1045MySQL:使用者存取被拒ORA-01017Oracle:使用者名稱/密碼無效;登入遭拒
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。