PostgreSQL数据库连接报错故障分析

PostgreSQL数据库连接报错：psql: error: FATAL: password authentication failed for user “postgres“

一、环境介绍

1.1 本次实践环境介绍

环境如下，使用yum方式安装PostgreSQL

hostname	IP地址	操作系统版本	PostgreSQL版本
jeven	192.168.3.166	centos 7.6	13.10

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数据库连接报错总结

数据库连接配置错误：检查连接参数是否正确，包括数据库地址、端口号、用户名、密码等，确保连接参数与实际情况相符。

数据库服务未启动：检查数据库服务是否已启动，如果未启动则需要手动启动数据库服务。

数据库权限问题：确保连接的用户具有访问数据库的权限。

防火墙或网络问题：确保防火墙未阻止数据库访问，并且网络连接正常。

数据库配置文件错误：检查数据库配置文件是否正确设置，如数据库监听地址等。

数据库版本不兼容：检查连接的客户端版本是否与数据库版本兼容。

审核编辑：黄飞