Spring Boot集成Hibernate连接PostgreSQL失败求助

1. 验证PostgreSQL本地登录有效性 #

• 直接在Linux Mint终端执行命令登录PostgreSQL：psql -U postgres，输入配置的密码，确认是否能成功登录。如果失败，说明PostgreSQL用户密码本身存在问题，需重置密码：
  1. 切换到postgres系统用户：sudo su - postgres
  2. 登录psql：psql
  3. 重置密码：ALTER USER postgres WITH PASSWORD '你的新密码';
  4. 退出psql：\q，再退出系统用户：exit

2. 核对application.properties配置准确性 #

• 重点检查以下配置项，确保无拼写或内容错误：
  • spring.datasource.url=jdbc:postgresql://localhost:5432/你的数据库名：确认端口（默认5432）、数据库名是否真实存在
  • spring.datasource.username=postgres：用户名是否与PostgreSQL中配置一致
  • spring.datasource.password=你的密码：密码需与PostgreSQL设置完全匹配，若含特殊字符（如#、!），需用引号包裹
  • Spring Boot 3.x环境下，可指定对应版本的Hibernate方言：spring.jpa.hibernate.dialect=org.hibernate.dialect.PostgreSQL14Dialect

3. 检查PostgreSQL的pg_hba.conf认证规则 #

• 定位pg_hba.conf文件（通常路径为/var/lib/postgresql/14/main/或/etc/postgresql/14/main/），确认本地连接的认证方式：
  • 确保针对localhost的连接条目使用md5或scram-sha-256认证（PostgreSQL 14默认用scram-sha-256），示例配置：

    host    all             all             127.0.0.1/32            scram-sha-256
    host    all             all             ::1/128                 scram-sha-256
    

  • 修改后重启PostgreSQL服务：sudo systemctl restart postgresql

4. 确认数据库服务状态与端口监听 #

• 检查PostgreSQL服务运行状态：sudo systemctl status postgresql，确保状态为active (running)
• 验证5432端口监听情况：ss -tulpn | grep 5432，确认有postgres进程监听该端口

5. 排查连接池配置（若自定义） #

• 若自定义了HikariCP等连接池，检查参数是否合理：
  • spring.datasource.hikari.maximum-pool-size：避免设置过大导致连接被拒绝
  • spring.datasource.hikari.connection-timeout：适当延长超时时间，防止因连接建立过慢报错
• 若使用Spring Boot默认HikariCP，确保无冲突的依赖或配置项

6. 开启详细日志定位根源 #

• 在application.properties中添加日志配置，输出完整连接过程：

  logging.level.org.hibernate.SQL=DEBUG
  logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
  logging.level.com.zaxxer.hikari=DEBUG
  logging.level.org.postgresql=DEBUG
  

• 启动应用后查看日志，确认连接请求的用户名、密码、数据库地址与配置是否一致，获取更具体的错误细节

内容的提问来源于stack exchange，提问作者Jéssica Zucco