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

• 一、环境介绍
• • 1.1 本次实践环境介绍
  • 1.2 PostgreSQL介绍
  • 1.3 PostgreSQL特点
  • 二、报错场景
  • 三、分析原因
  • 四、检查相关配置
  • 五、相关场景报错解决办法
  • • 5.1 登录密码忘记
    • 5.2 密码设置错误或未设置
    • 5.3 配置文件出错
    • 5.4 设置免密登录
    • 5.5 环境问题
    • 六、PostgreSQL数据库连接报错总结

      一、环境介绍

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

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

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

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

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

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

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