Spring Boot 的 mvn package 默认生成含依赖的可执行 jar,若报 NoClassDefFoundError,说明打成了不含依赖的“瘦包”,需确认使用 spring-boot-maven-plugin 且未被 maven-jar-plugin 干扰。

mvn package 打出来的 jar 为什么运行时报错 NoClassDefFoundError
Spring Boot 默认用 spring-boot-maven-plugin 打成可执行 jar,不是普通 jar。如果手动写了 maven-jar-plugin 或没配插件,mvn package 会生成一个不含依赖的“瘦包”,运行时自然找不到类。
- 检查
pom.xml是否有spring-boot-maven-plugin,且<executions>绑定在package阶段 - 确认没同时启用
maven-jar-plugin的<archive>配置干扰了主类声明 - 运行前先用
jar -tf target/xxx.jar | head -20看目录结构:正常 Spring Boot jar 里应有BOOT-INF/classes/和BOOT-INF/lib/,而不是直接平铺com/xxx/
java -jar 启动时怎么传入配置文件和 JVM 参数
Spring Boot 支持多种外部配置加载方式,但顺序和写法容易混淆;JVM 参数必须放在 -jar 前,否则会被当成应用参数。
- JVM 参数(如堆大小、GC 日志)写在
java命令后、-jar前:java -Xmx512m -XX:+PrintGCDetails -jar app.jar - Spring 配置参数(如
--server.port=8081)必须写在app.jar后面:java -jar app.jar --server.port=8081 - 外部
application.yml优先级高于 jar 内部:加--spring.config.location=file:./config/application.yml,注意路径是file:开头,且文件需存在 - 多个配置文件用逗号分隔:
--spring.config.location=file:./a.yml,file:./b.yml
打出来的 jar 包启动慢、内存占用高,是不是打包有问题
不是打包问题,是 Spring Boot 可执行 jar 的加载机制决定的——它用自定义 ClassLoader 解压并加载 BOOT-INF/lib/ 下的 jar,比传统 classpath 启动略重,但这是功能代价。
- 首次启动慢常见于启用 Actuator + Prometheus + JMX 等监控端点,可关掉不用的:
--management.endpoints.web.exposure.include=health,info - 内存高往往因为默认堆设得大,或日志框架(如 Logback)加载了大量扫描逻辑;加
-Dlogback.debug=false关闭调试输出能快一点 - 不要试图用
mvn clean compile assembly:single替代spring-boot-maven-plugin,那样会丢掉 Spring Boot 的启动器和资源定位逻辑,反而更不稳定
Windows 上双击 jar 没反应,命令行运行却正常
双击走的是系统默认的 javaw.exe,不显示控制台,出错也看不到日志;而 java -jar 走的是 java.exe,带标准输出。
立即学习“Java免费学习笔记(深入)”;
- 别双击,改用命令行:
java -jar app.jar或写个start.bat,内容为@java -jar app.jar & pause - 如果坚持双击,至少加日志输出:
java -jar app.jar > app.log 2>&1,再把这行写进 bat - 检查是否装了多个 JDK,注册表里默认 Java 关联可能指向 JRE 而非 JDK,导致缺少某些模块(如
java.desktop)引发静默失败
mvn clean package 和 java -jar 命令固化进 CI 脚本,别靠手工拼。











