Spring Boot应用启动报错：PostgreSQL连接失败及依赖注入异常排查

一、先解决核心的连接失败问题 #

org.postgresql.util.PSQLException: The connection attempt failed 是所有问题的根源，Bean创建失败都是因为数据库连接池初始化失败，先从这里入手：

1. 核对application.yml数据库配置 #

逐一检查以下配置项：

• 数据库URL：格式必须是 jdbc:postgresql://<主机地址>:<端口>/<数据库名>，默认端口是5432，别写错；本地库用localhost/127.0.0.1，远程库要确认地址正确
• 账号密码：确保用户名和密码对应目标数据库的有效账号，且该账号有访问目标库的权限
• 驱动类：PostgreSQL驱动类是 org.postgresql.Driver，不要写成其他数据库的驱动

2. 确认PostgreSQL服务状态 #

• 本地库：检查PostgreSQL服务是否启动，Windows看服务列表，Linux用systemctl status postgresql命令查看
• 远程库：先用ping <主机地址>测网络通不通，再用telnet <主机地址> <端口>或nc -zv <主机地址> <端口>验证端口是否开放

3. 检查pom.xml的PostgreSQL依赖 #

确保驱动版本和服务器版本兼容（比如服务器15.x对应驱动42.5.x），依赖配置正确：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

如果手动指定了版本，用mvn dependency:tree检查是否有依赖冲突，避免多个版本的驱动共存

二、处理Bean创建失败的连锁问题 #

UnsatisfiedDependencyException 是因为依赖的Repository/DataSource Bean无法初始化，解决连接问题后通常会自动消失，也可以额外检查：

• MovieService中注入的Repository是否正确，比如是否用了@Autowired或构造注入，Repository接口是否正确继承了Spring Data的JpaRepository（或对应接口）
• 有没有自定义的DataSource配置类覆盖了默认自动配置，导致连接参数未生效

三、进阶排查手段 #

如果以上步骤没解决，试试：

• 开启连接日志，在application.yml中添加：

logging:
  level:
    org.springframework.jdbc: DEBUG
    org.postgresql: DEBUG

通过详细日志看具体是超时、认证失败还是数据库不存在

• 用pgAdmin、DBeaver等客户端，用相同的账号密码、地址端口连接数据库，确认配置本身没问题

内容的提问来源于stack exchange，提问作者Edgar