SpringBoot项目无法连接PostgreSQL启动失败求助

• 检查配置文件位置与内容准确性
  确保application.properties放在src/main/resources目录下，核对PostgreSQL配置项的拼写与格式：

  spring.datasource.url=jdbc:postgresql://localhost:5432/你的数据库名称
  spring.datasource.username=数据库用户名
  spring.datasource.password=数据库密码
  spring.datasource.driver-class-name=org.postgresql.Driver
  

  注意避免拼写错误（比如把url写成uri）、多余空格或格式错乱。

• 验证pom.xml依赖有效性
  确认postgresql依赖版本与SpringBoot版本适配（SpringBoot 2.x对应42.2+版本，3.x对应42.5+版本），依赖代码需正确：

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

  执行mvn clean install重新构建项目，确保依赖已正确下载至本地仓库。

• 排查启动类注解配置
  若项目需要数据源，确保启动类未错误排除DataSourceAutoConfiguration；若不需要数据源，可通过注解排除自动配置：

  @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
  

• 检查环境配置优先级

  • 若存在多环境配置文件（如application-dev.properties），确认启动时通过--spring.profiles.active=dev激活了正确的配置文件。
  • 排查系统环境变量、JVM参数是否覆盖了application.properties中的配置（比如SPRING_DATASOURCE_URL等环境变量会优先生效）。

• 确认数据库服务状态
  检查PostgreSQL服务是否正常启动，端口与配置一致；用psql或其他客户端工具测试连接，验证用户名、密码、数据库名的有效性。

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