Spring Boot可执行Jar无法连接数据库：DataSource 'url'属性错误

常见原因及修复步骤 #

1. 配置文件打包遗漏 #

• 确认application.properties放在src/main/resources目录下，这是Spring Boot默认读取配置的路径，打包时会自动将该目录文件纳入Jar的BOOT-INF/classes目录。
• 用解压工具打开生成的Jar包，检查BOOT-INF/classes下是否存在application.properties，若缺失则重新执行Maven/Gradle的package命令，确保打包过程无报错。

2. 多环境配置未激活 #

• 若使用多环境配置（如application-dev.properties），IDE中可能默认激活了对应环境，但Jar启动时需手动指定：

  java -jar your-project.jar --spring.profiles.active=dev
  

  替换dev为你实际使用的环境标识。

3. 配置项错误或占位符未替换 #

• 检查数据源配置的拼写正确性，示例正确配置：

  spring.datasource.url=jdbc:postgresql://localhost:5432/your_db_name
  spring.datasource.username=your_username
  spring.datasource.password=your_password
  spring.datasource.driver-class-name=org.postgresql.Driver
  

• 若使用Maven/Gradle资源过滤（如@db.url@占位符），打开Jar内的application.properties确认占位符是否被实际值替换，未替换则检查构建工具的资源过滤配置。

4. 外部配置覆盖Jar内配置 #

• Spring Boot启动时，命令行参数、系统变量等外部配置会优先覆盖Jar内配置，检查启动命令是否传入了空的数据源参数，或系统环境变量存在冲突配置。
• 启动时添加--debug参数查看配置加载日志，定位实际生效的配置来源：

  java -jar your-project.jar --debug
  

5. PostgreSQL驱动依赖未打包 #

• 确认Maven/Gradle中PostgreSQL驱动依赖未设置为provided scope（该scope下依赖不会打入Jar），Maven示例配置：

  <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <!-- 不要添加<scope>provided</scope> -->
  </dependency>
  

• 检查Jar包的BOOT-INF/lib目录，确认存在postgresql-xxx.jar，缺失则调整依赖配置后重新打包。

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