使用bootRun可运行项目但java -jar无法运行的问题咨询

我来帮你拆解下这两个命令的核心差异，以及可能导致jar运行失败的常见原因：

一、两个命令的本质区别 #

• 运行环境与类加载逻辑不同

  • ./gradlew bootRun：这是Spring Boot专门给Gradle提供的开发调试任务，它直接在Gradle的构建环境里启动应用。会自动帮你处理好所有依赖的类路径，包括编译、运行时的所有依赖，甚至能直接读取项目里src/main/resources下的配置文件，完全不需要先打包成jar就能跑。
  • java -jar build/libs/my_application.jar：这是纯Java命令执行可执行jar包，要求这个jar必须是Spring Boot的fat jar——也就是把你的代码、所有依赖库、Spring Boot启动器全部打包在一起的完整jar。此时类加载完全遵循Java的jar规范，所有需要的资源和依赖都得已经在jar包里。

• 构建阶段的差异
  bootRun不需要先完成完整的jar打包，编译完代码就能启动，特别适合开发时快速调试；而java -jar必须先通过bootJar任务生成可执行jar，不然连对应的jar文件都找不到。

二、为什么java -jar会失败？常见排查方向 #

• 你生成的不是可执行fat jar
  如果你只跑了./gradlew jar而不是./gradlew bootJar，得到的只是一个普通的编译jar——里面只有你的代码，没有打包任何依赖和Spring Boot的启动逻辑。这种情况下跑java -jar肯定会报错找不到依赖类或者主类。解决办法：执行./gradlew bootJar生成完整的可执行jar。

• 资源文件没被正确打包
  bootRun会直接读项目里的src/main/resources配置，但打包时如果Gradle配置排除了某些资源，或者资源路径配置错了，jar包里就没有这些文件。你可以打开jar包，检查BOOT-INF/classes目录下有没有你的application.properties之类的配置文件。

• 主类清单配置缺失
  Spring Boot可执行jar需要在META-INF/MANIFEST.MF里指定Main-Class（一般是org.springframework.boot.loader.JarLauncher）和Start-Class（你的应用主类）。如果打包时没生成这个配置，运行java -jar就会提示“没有主清单属性”。确保你的build.gradle里引入了spring-boot-gradle-plugin，它会自动帮你配置这些。

• 依赖冲突或缺失
  虽然bootRun和bootJar理论上用的是同一套依赖，但有时候打包过程中可能因为依赖配置问题（比如手动exclude了某个必要依赖，或者动态依赖没被打包），导致jar运行时找不到类。你可以对比bootRun的类路径和jar包里BOOT-INF/lib目录下的依赖是否一致。

• 环境变量/系统属性不一致
  bootRun会继承Gradle运行时的环境变量和系统属性，但java -jar是独立运行的，可能缺少某些必要的配置（比如数据库地址、端口、环境标识）。可以试试在java -jar命令里加上参数，比如java -Dspring.profiles.active=prod -jar build/libs/my_application.jar，和bootRun用相同的环境配置。

内容的提问来源于stack exchange，提问作者Mihkel L.