PostgreSQL數據庫連接報錯：psql: error: FATAL: password authentication failed for user “postgres“

一、環境介紹

1.1 本次實踐環境介紹

環境如下，使用yum方式安裝PostgreSQL

1.2 PostgreSQL介紹

PostgreSQL（經常被簡稱為Postgres）是一個開源的關系型數據庫管理系統，它基于SQL語言實現了所有主流功能，支持事務處理、并發控制、復雜查詢、外鍵、觸發器、存儲過程等高級功能。它具備高度可擴展性、穩定性和安全性，是許多大型企業級應用的首選數據庫系統之一。

1.3 PostgreSQL特點

開源免費：PostgreSQL是一個開源軟件，可以免費使用和修改源代碼，同時也可以在商業項目中使用。

高度可擴展：PostgreSQL支持水平擴展和垂直擴展，可以輕松地處理海量數據和高并發請求。

多種數據類型支持：PostgreSQL支持許多數據類型，包括JSON、數組、范圍、XML、UUID等等。

備份和恢復：PostgreSQL提供了多種備份和恢復方式，包括物理備份和邏輯備份等。

安全性：PostgreSQL提供了許多安全機制，如SSL/TLS加密、訪問控制、認證和授權等。

擴展性：PostgreSQL支持許多擴展，如空間數據支持、全文本搜索等。

二、報錯場景

遠程連接PostgreSQL數據庫時，密碼驗證錯誤。

[root@jeven ~]#  psql -h192.168.3.166  -Upostgres -W
Password:
psql: error: FATAL:  password authentication failed for user "postgres"

三、分析原因

分析以下可能原因，進行逐一排查。

1.密碼忘記輸入錯誤；
2./var/lib/pgsql/13/data/postgresql.conf文件配置錯誤；
3./var/lib/pgsql/13/data/pg_hba.conf文件配置錯誤；
4.設置數據庫用戶密碼時錯誤。

四、檢查相關配置

檢查/var/lib/pgsql/13/data/postgresql.conf文件嗎，以下內容是否修改正確。

listen_addresses = '*'# what IP address(es) to listen on;

檢查/var/lib/pgsql/13/data/pg_hba.conf文件，以下內容是否修改正確。

host    all            all      127.0.0.1/32      ident
host    all            all      0.0.0.0/0  md5

檢查以上都正確后，重啟服務，再行測試。

五、相關場景報錯解決辦法

5.1 登錄密碼忘記

當忘記登錄密碼，登錄本地PostgreSQL，重置密碼。

su - postgres

psql -c " ALTER USER postgres WITH PASSWORD 'postgres';"

5.2 密碼設置錯誤或未設置

數據庫的密碼設置錯誤或未設置，在連接到本地服務后，重新設置即可。本次錯誤就是大意將密碼錯打了一個字母。

sudo -u postgres
psql -c " ALTER USER postgres WITH PASSWORD 'postgres';"

5.3 配置文件出錯

當配置文件出錯，嘗試以下修改。

檢查/var/lib/pgsql/13/data/postgresql.conf文件嗎，以下內容是否修改正確。

listen_addresses = '*'# what IP address(es) to listen on;

檢查/var/lib/pgsql/13/data/pg_hba.conf文件，以下內容是否修改正確。

host    all            all      127.0.0.1/32      ident
host    all            all      0.0.0.0/0  md5

檢查以上都正確后，重啟服務，再行測試。

5.4 設置免密登錄

當本地登錄出現問題時，可以臨時設置免密登錄，修改密碼完成后，再將配置文件/var/lib/pgsql/13/data/pg_hba.conf修改為原來的。

設置免密登錄

vim /var/lib/pgsql/13/data/pg_hba.conf

host    all            all      127.0.0.1/32     trust
host    all            all      0.0.0.0/0  trust

5.5 環境問題

清空環境或者換一個新環境，重新部署PostgreSQL數據庫。

六、PostgreSQL數據庫連接報錯總結

數據庫連接配置錯誤：檢查連接參數是否正確，包括數據庫地址、端口號、用戶名、密碼等，確保連接參數與實際情況相符。

數據庫服務未啟動：檢查數據庫服務是否已啟動，如果未啟動則需要手動啟動數據庫服務。

數據庫權限問題：確保連接的用戶具有訪問數據庫的權限。

防火墻或網絡問題：確保防火墻未阻止數據庫訪問，并且網絡連接正常。

數據庫配置文件錯誤：檢查數據庫配置文件是否正確設置，如數據庫監聽地址等。

數據庫版本不兼容：檢查連接的客戶端版本是否與數據庫版本兼容。

審核編輯：黃飛