spring-boot-maven-plugin 将spring打包成单个jar的工作原理

spring-boot-maven-plugin 是 Spring Boot 的 Maven 插件,它的核心功能是将 Spring Boot 项目打包成一个独立的、可执行的 Fat JAR(包含所有依赖的 JAR 包)。以下是它的工作原理详解:


1. 默认 Maven 打包 vs Spring Boot 插件打包

  • 标准 Maven 打包 :

    默认的 maven-jar-plugin 会生成一个普通的 JAR 包,仅包含项目的编译类文件(target/classes)和资源文件,不包含依赖库。

  • Spring Boot 插件打包 :
    spring-boot-maven-plugin 会生成一个 Fat JAR ,将项目的代码、资源文件以及所有依赖的第三方库(BOOT-INF/lib)和启动类加载器(org.springframework.boot.loader)打包到同一个 JAR 中,使其可以直接通过 java -jar 运行。


2. Fat JAR 的核心结构

生成的 Fat JAR 包含以下关键目录和文件:

your-app.jar

├── BOOT-INF

│ ├── classes # 项目的编译类文件(对应 src/main/java 和 src/main/resources)

│ └── lib # 所有依赖的第三方 JAR 文件

├── META-INF

│ ├── MANIFEST.MF # JAR 包的元数据(指定启动类、类路径等)

│ └── maven # Maven 构建信息

└── org

└── springframework

┣── boot

┗── loader # Spring Boot 的类加载器(JarLauncher)


3. 核心工作原理

3.1 依赖嵌入
  • 插件通过 Maven Shade Plugin 的变体,将所有依赖的 JAR 文件解压并合并到 BOOT-INF/lib 目录中。
  • 依赖库的路径会被记录在 MANIFEST.MF 的 Class-Path 属性中。
3.2 启动类加载器
  • Spring Boot 使用自定义的类加载器 org.springframework.boot.loader.Launcher(如 JarLauncher)来启动应用。

  • MANIFEST.MF 中的关键属性:

    Main-Class: org.springframework.boot.loader.JarLauncher # 启动入口

    Start-Class: com.example.YourApplication # 用户定义的 Spring Boot 主类

3.3 启动流程
  1. 执行 java -jar your-app.jar 时,JVM 根据 MANIFEST.MF 找到 JarLauncher。
  2. JarLauncher 负责:
    • 加载 BOOT-INF/lib 中的依赖库。
    • 找到 Start-Class(即用户定义的 @SpringBootApplication 主类)。
    • 调用 SpringApplication.run() 启动 Spring Boot 应用。

4. 插件配置示例(pom.xml)

org.springframework.boot spring-boot-maven-plugin com.example.YourApplication true org.unwanted unwanted-lib repackage


5. 关键 Maven 生命周期阶段

  • package 阶段 :
    Maven 默认会先调用 maven-jar-plugin 生成普通 JAR(如 your-app-0.0.1.jar)。
  • repackage 目标 :
    spring-boot-maven-plugin 的 repackage 目标会在此基础上,将普通 JAR 和依赖重新打包为 Fat JAR(如 your-app-0.0.1.jar,覆盖原文件)。

6. 高级特性

6.1 分层打包(Layered JAR)
  • 目的:优化 Docker 镜像构建(利用分层缓存)。
  • 结构 :
    • dependencies:第三方依赖。
    • spring-boot-loader:Spring Boot 类加载器。
    • snapshot-dependencies:快照依赖。
    • application:应用代码和资源。
6.2 排除依赖

通过 <excludes> 配置移除不需要的依赖,减少 JAR 包体积。


7. 总结

  • 核心功能:将 Spring Boot 应用及其依赖打包成一个自包含的 JAR。
  • 关键机制 :自定义类加载器(JarLauncher)和嵌套依赖结构(BOOT-INF/lib)。
  • 优势:简化部署,无需外部 Web 服务器或依赖管理。
  • 适用场景:独立运行、容器化部署(Docker)等。
相关推荐
Flynn Liang11 小时前
AI 应用的安全红线:Spring AI 下的 Prompt 注入防护、PII 脱敏、输出审计与密钥管理
人工智能·安全·spring·数据泄露·springai·prompt注入
QCoding11 小时前
企业级Agent Evaluation实战:Agent能跑就能上线?AI Agent到底怎么测?
后端·spring
Flynn Liang18 小时前
Spring AI 上生产:限流熔断、密钥与成本治理、私有化/混合部署、降级与 Prompt 灰度架构全解
人工智能·spring·架构·高可用·springai·成本治理·生产架构
Flynn Liang19 小时前
Spring AI 2.0 深度解析:ChatClient、Advisor 链与 MCP——Java 工程师的 AI 落地最优解
java·人工智能·spring·大模型·架构设计·spring ai
雪芽蓝域zzs20 小时前
第 1 章:IDEA 创建 SpringBoot3.5.16 Maven 项目
java·maven·intellij-idea
liangbo721 小时前
Spring系列01:IoC 与 DI 到底解决了什么
java·spring
无所谓^_^1 天前
个人健康管理系统 | Springboot3 | Vue3
java·vue·毕业设计·springboot·课程设计·毕设·前后端分离
杨凯凡1 天前
Spring Boot 的 @Transactional 为什么会失效?从代理、自调用到异常回滚的排查实战
java·spring boot·spring·事务·后端开发
哦虎!1 天前
【JavaEE进阶】SpringBoot
spring
霸道流氓气质1 天前
AI 流式对话与实时聊天平台:SSE 解码竞态、有状态会话隔离与背压取消的 Vue3 + Spring AI 生产级实战
java·人工智能·spring