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

一、環(huán)境介紹

1.1 本次實踐環(huán)境介紹

環(huán)境如下，使用yum方式安裝PostgreSQL

1.2 PostgreSQL介紹

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

1.3 PostgreSQL特點

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

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

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

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

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

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

二、報錯場景

遠程連接PostgreSQL數(shù)據(jù)庫時，密碼驗證錯誤。

[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.設(shè)置數(shù)據(jù)庫用戶密碼時錯誤。

四、檢查相關(guān)配置

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

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

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

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

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

五、相關(guān)場景報錯解決辦法

5.1 登錄密碼忘記

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

su - postgres

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

5.2 密碼設(shè)置錯誤或未設(shè)置

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

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

5.3 配置文件出錯

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

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

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

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

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

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

5.4 設(shè)置免密登錄

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

設(shè)置免密登錄

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 環(huán)境問題

清空環(huán)境或者換一個新環(huán)境，重新部署PostgreSQL數(shù)據(jù)庫。

六、PostgreSQL數(shù)據(jù)庫連接報錯總結(jié)

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

數(shù)據(jù)庫服務(wù)未啟動：檢查數(shù)據(jù)庫服務(wù)是否已啟動，如果未啟動則需要手動啟動數(shù)據(jù)庫服務(wù)。

數(shù)據(jù)庫權(quán)限問題：確保連接的用戶具有訪問數(shù)據(jù)庫的權(quán)限。

防火墻或網(wǎng)絡(luò)問題：確保防火墻未阻止數(shù)據(jù)庫訪問，并且網(wǎng)絡(luò)連接正常。

數(shù)據(jù)庫配置文件錯誤：檢查數(shù)據(jù)庫配置文件是否正確設(shè)置，如數(shù)據(jù)庫監(jiān)聽地址等。

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

審核編輯：黃飛