SpringBoot中Fat Jar的三種打包方式詳解

更新時間：2025年06月13日 08:16:20 作者：風象南

Spring Boot開發(fā)中,打包是將應用及其所有依賴整合到一個可執(zhí)行文件中的過程,這種包含所有依賴的jar文件通常被稱為"Fat Jar",下面我們來看看SpringBoot打包Fat Jar的三種方式吧

在Spring Boot應用開發(fā)中，打包是將應用及其所有依賴整合到一個可執(zhí)行文件中的過程，這種包含所有依賴的jar文件通常被稱為"Fat Jar"。

一、Spring Boot Maven/Gradle插件默認打包方式

1.1 基本原理

Spring Boot提供了官方的Maven和Gradle插件，用于創(chuàng)建可執(zhí)行的jar或war文件。

這是最常用的打包方式，也是Spring Boot官方推薦的方法。

該插件會創(chuàng)建一個包含應用代碼、依賴庫以及嵌入式容器（如果需要）的自包含可執(zhí)行jar文件。

Spring Boot的jar包采用了特殊的"嵌套jar"結構，它通過自定義的JarLauncher類加載各個嵌套的jar包，避免了傳統(tǒng)"胖jar"中的類路徑問題。

1.2 配置方式

Maven配置

在pom.xml文件中添加Spring Boot Maven插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.7.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

執(zhí)行打包命令：

mvn clean package

Gradle配置

在build.gradle文件中應用Spring Boot插件：

plugins {
    id 'org.springframework.boot' version '2.7.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
}

// 其他配置...

bootJar {
    archiveBaseName = 'myapp'
    archiveVersion = '1.0.0'
}

執(zhí)行打包命令：

./gradlew bootJar

1.3 打包結構分析

Spring Boot Maven/Gradle插件創(chuàng)建的Fat Jar具有以下結構：

myapp.jar
├── META-INF
│ ├── MANIFEST.MF
│ └── maven
│ └── ...
├── BOOT-INF
│ ├── classes
│ │ └── com
│ │ └── example
│ │ └── myapp
│ │ └── ...
│ └── lib
│ ├── dependency1.jar
│ ├── dependency2.jar
│ └── ...
└── org
└── springframework
└── boot
└── loader
└── ...

主要組成部分：

META-INF/MANIFEST.MF：包含啟動類信息和類加載器信息
BOOT-INF/classes：應用的編譯類文件
BOOT-INF/lib：應用的所有依賴jar文件
org/springframework/boot/loader：Spring Boot自定義的類加載器

1.4 運行方式

通過以下命令運行打包后的Fat Jar：

java -jar myapp.jar

也可以指定配置文件或JVM參數(shù)：

java -Dspring.profiles.active=prod -Xmx512m -jar myapp.jar

1.5 高級配置

可以通過Spring Boot插件配置自定義打包行為：

Maven

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <!-- 排除指定依賴 -->
        <excludes>
            <exclude>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </exclude>
        </excludes>
        <!-- 指定主類 -->
        <mainClass>com.example.myapp.Application</mainClass>
        <!-- 包含系統(tǒng)范圍依賴 -->
        <includeSystemScope>true</includeSystemScope>
        <!-- 排除開發(fā)工具 -->
        <excludeDevtools>true</excludeDevtools>
        <!-- 創(chuàng)建分層jar -->
        <layers>
            <enabled>true</enabled>
        </layers>
    </configuration>
</plugin>

Gradle

bootJar {
&nbsp; &nbsp; archiveBaseName = 'myapp'
&nbsp; &nbsp; archiveVersion = '1.0.0'
&nbsp; &nbsp; mainClass = 'com.example.myapp.Application'
&nbsp; &nbsp;&nbsp;
&nbsp; &nbsp; // 排除特定依賴
&nbsp; &nbsp; excludeDevtools = true
&nbsp; &nbsp;&nbsp;
&nbsp; &nbsp; // 啟用分層支持
&nbsp; &nbsp; layered {
&nbsp; &nbsp; &nbsp; &nbsp; enabled = true
&nbsp; &nbsp; }
}

1.6 優(yōu)缺點分析

優(yōu)點：

官方支持，與Spring Boot完全兼容
采用嵌套jar結構，避免了依賴沖突
支持直接運行
提供豐富的配置選項

缺點：

啟動時間可能略長，因為需要解析嵌套jar
特殊的jar結構不符合標準jar規(guī)范
某些工具可能無法正確處理嵌套jar結構
排查類加載問題相對復雜

1.7 適用場景

標準Spring Boot應用部署
容器化部署(Docker)
云平臺部署
需要完整Spring Boot功能的場景

二、Maven Shade插件打包方式

2.1 基本原理

Maven Shade插件是一個通用的打包工具，不僅限于Spring Boot應用。

它通過將所有依賴解壓并重新打包到一個jar文件中，創(chuàng)建一個包含所有類文件的單一jar包。

與Spring Boot插件不同，Shade創(chuàng)建的jar包沒有嵌套結構，所有類都位于同一個類路徑下。

2.2 配置方式

在pom.xml文件中添加Maven Shade插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <!-- 合并META-INF/spring.factories文件 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                <resource>META-INF/spring.factories</resource>
                            </transformer>
                            <!-- 合并META-INF/spring.handlers文件 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                <resource>META-INF/spring.handlers</resource>
                            </transformer>
                            <!-- 合并META-INF/spring.schemas文件 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                <resource>META-INF/spring.schemas</resource>
                            </transformer>
                            <!-- 設置主類 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>com.example.myapp.Application</mainClass>
                            </transformer>
                        </transformers>
                        <!-- 過濾一些文件 -->
                        <filters>
                            <filter>
                                <artifact>*:*</artifact>
                                <excludes>
                                    <exclude>META-INF/*.SF</exclude>
                                    <exclude>META-INF/*.DSA</exclude>
                                    <exclude>META-INF/*.RSA</exclude>
                                </excludes>
                            </filter>
                        </filters>
                        <!-- 創(chuàng)建可執(zhí)行jar -->
                        <createDependencyReducedPom>false</createDependencyReducedPom>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

執(zhí)行打包命令：

mvn clean package

2.3 打包結構分析

Shade插件創(chuàng)建的Fat Jar具有以下結構：

myapp.jar
├── META-INF
│ ├── MANIFEST.MF
│ ├── spring.factories
│ ├── spring.handlers
│ ├── spring.schemas
│ └── maven
│ └── ...
├── com
│ └── example
│ └── myapp
│ └── ...
├── org
│ └── springframework
│ └── ...
└── ...

主要特點：

所有依賴的類文件都被解壓并重新打包到同一個jar中
沒有嵌套jar結構，所有類都在同一個類路徑下
需要特殊處理合并META-INF下的特殊文件

2.4 運行方式

與Spring Boot插件創(chuàng)建的jar包相同，可以通過以下命令運行：

java -jar myapp.jar

2.5 高級配置

處理類沖突

當多個依賴包含相同的類時，可以使用relocation功能重命名包名以避免沖突：

<configuration>
    <relocations>
        <relocation>
            <pattern>com.google.common</pattern>
            <shadedPattern>com.example.shaded.com.google.common</shadedPattern>
        </relocation>
    </relocations>
</configuration>

最小化最終jar

可以配置Shade插件僅包含必要的類：

<configuration>
    <minimizeJar>true</minimizeJar>
</configuration>

自定義輸出文件名

<configuration>
    <finalName>myapp-${project.version}-fat</finalName>
</configuration>

2.6 優(yōu)缺點分析

優(yōu)點：

創(chuàng)建標準jar結構，兼容性好
支持類重定位，解決依賴沖突
可以最小化最終jar大小
可以處理非Spring Boot應用

缺點：

需要手動處理META-INF資源文件合并
可能存在類路徑?jīng)_突問題
配置相對復雜
對于大型應用，打包過程可能較慢

2.7 適用場景

需要標準jar結構的場景
非Spring Boot應用
有特殊類路徑需求的項目
需要最小化最終jar大小的場景
需要處理復雜依賴沖突的項目

三、Maven Assembly插件打包方式

3.1 基本原理

Maven Assembly插件是一個靈活的打包工具，可以創(chuàng)建自定義格式的分發(fā)包，包括jar、zip、tar等。

對于Spring Boot應用，它可以創(chuàng)建包含所有依賴的可執(zhí)行jar，類似于Shade插件，但配置方式和功能有所不同。

Assembly插件更注重于創(chuàng)建完整的分發(fā)包，可以包含配置文件、啟動腳本等。

3.2 配置方式

在pom.xml文件中添加Assembly插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>com.example.myapp.Application</mainClass>
                    </manifest>
                </archive>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

執(zhí)行打包命令：

mvn clean package

3.3 自定義Assembly描述符

對于更復雜的打包需求，可以創(chuàng)建自定義的Assembly描述符文件：

創(chuàng)建src/assembly/dist.xml文件：

<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.1.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.1.0 http://maven.apache.org/xsd/assembly-2.1.0.xsd">
    <id>distribution</id>
    <formats>
        <format>zip</format>
    </formats>
    <includeBaseDirectory>true</includeBaseDirectory>
    
    <fileSets>
        <!-- 應用jar文件 -->
        <fileSet>
            <directory>${project.build.directory}</directory>
            <outputDirectory>lib</outputDirectory>
            <includes>
                <include>${project.build.finalName}.jar</include>
            </includes>
        </fileSet>
        <!-- 配置文件 -->
        <fileSet>
            <directory>src/main/resources</directory>
            <outputDirectory>config</outputDirectory>
            <includes>
                <include>application*.yml</include>
                <include>application*.properties</include>
                <include>logback*.xml</include>
            </includes>
        </fileSet>
        <!-- 啟動腳本 -->
        <fileSet>
            <directory>src/main/scripts</directory>
            <outputDirectory>bin</outputDirectory>
            <includes>
                <include>*.sh</include>
                <include>*.bat</include>
            </includes>
            <fileMode>0755</fileMode>
        </fileSet>
    </fileSets>
    
    <!-- 所有依賴 -->
    <dependencySets>
        <dependencySet>
            <outputDirectory>lib</outputDirectory>
            <excludes>
                <exclude>${project.groupId}:${project.artifactId}</exclude>
            </excludes>
        </dependencySet>
    </dependencySets>
</assembly>

然后在pom.xml中引用該描述符：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <descriptors>
            <descriptor>src/assembly/dist.xml</descriptor>
        </descriptors>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

3.4 創(chuàng)建可執(zhí)行jar

如果需要創(chuàng)建可執(zhí)行jar，需要添加maven-jar-plugin配置主類：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
        <archive>
            <manifest>
                <addClasspath>true</addClasspath>
                <classpathPrefix>lib/</classpathPrefix>
                <mainClass>com.example.myapp.Application</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

3.5 打包結構分析

使用默認jar-with-dependencies描述符創(chuàng)建的Fat Jar結構：

myapp-jar-with-dependencies.jar
├── META-INF
│ ├── MANIFEST.MF
│ └── maven
│ └── ...
├── com
│ └── example
│ └── myapp
│ └── ...
├── org
│ └── springframework
│ └── ...
└── ...

使用自定義描述符創(chuàng)建的分發(fā)包結構：

myapp-distribution.zip
├── bin
│ ├── start.sh
│ └── start.bat
├── config
│ ├── application.yml
│ └── logback.xml
└── lib
├── myapp.jar
├── dependency1.jar
├── dependency2.jar
└── ...

3.6 運行方式

對于使用jar-with-dependencies創(chuàng)建的可執(zhí)行jar：

java -jar myapp-jar-with-dependencies.jar

對于自定義分發(fā)包，使用提供的啟動腳本：

cd myapp-distribution
./bin/start.sh

或手動啟動：

cd myapp-distribution
java -cp "lib/*" com.example.myapp.Application

3.7 優(yōu)缺點分析

優(yōu)點：

高度靈活，支持自定義分發(fā)包格式
可以包含配置文件、啟動腳本等
支持多種打包格式（jar, zip, tar等）
可以為不同環(huán)境創(chuàng)建不同的分發(fā)包
適合創(chuàng)建完整的應用分發(fā)包

缺點：

配置相對復雜
對于簡單應用，配置過于繁瑣
需要額外處理類路徑和資源文件

3.8 適用場景

需要完整分發(fā)包的企業(yè)應用
包含多個模塊的復雜應用
需要包含配置文件和啟動腳本的場景
需要為不同環(huán)境創(chuàng)建不同分發(fā)包的場景
有特殊分發(fā)需求的項目

四、總結

合理的打包策略能顯著提升開發(fā)和部署效率，是應用成功運行的重要環(huán)節(jié)。

通過選擇合適的打包方式，可以減少環(huán)境差異帶來的問題，提升應用的可移植性和可維護性。

到此這篇關于SpringBoot中Fat Jar的三種打包方式詳解的文章就介紹到這了,更多相關SpringBoot打包Fat Jar內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

java開發(fā)hutool HttpUtil網(wǎng)絡請求工具使用demo
這篇文章主要為大家介紹了hutool之HttpUtil網(wǎng)絡請求工具使用示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪
2023-07-07
Java實現(xiàn)Consul/Nacos根據(jù)GPU型號、顯存余量執(zhí)行負載均衡的步驟詳解
這篇文章主要介紹了Java實現(xiàn)Consul/Nacos根據(jù)GPU型號、顯存余量執(zhí)行負載均衡的步驟詳解,本文分步驟結合實例代碼給大家介紹的非常詳細,需要的朋友可以參考下
2025-04-04
springboot解決前后端分離時的跨域問題
這篇文章主要介紹了springboot如何解決前后端分離時的跨域問題，幫助大家更好的理解和學習使用springboot，感興趣的朋友可以了解下
2021-04-04
java 中模式匹配算法-KMP算法實例詳解
這篇文章主要介紹了java 中模式匹配算法-KMP算法實例詳解的相關資料,需要的朋友可以參考下
2017-06-06
IDEA修改java文件后不用重啟Tomcat服務便可實現(xiàn)自動更新
這篇文章主要介紹了IDEA修改java文件后不用重啟Tomcat服務便可實現(xiàn)自動更新,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
2023-11-11
Java中SimpleDateFormat用法詳解
SimpleDateFormat 是一個以國別敏感的方式格式化和分析數(shù)據(jù)的具體類。它允許格式化 (date -> text)、語法分析 (text -> date)和標準化.這篇文章主要介紹了Java中SimpleDateFormat用法詳解,需要的朋友可以參考下
2017-03-03
SpringBoot中過濾器Filter+JWT令牌實現(xiàn)登錄驗證
本文主要介紹了SpringBoot中過濾器Filter+JWT令牌實現(xiàn)登錄驗證,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
2024-04-04
關于post請求內(nèi)容無法重復獲取的解決方法
這篇文章主要介紹了關于post請求內(nèi)容無法重復獲取的解決方法,文中通過代碼示例給大家介紹的非常詳細,對大家的學習或工作有一定的幫助,需要的朋友可以參考下
2024-03-03
基于Mybatis plus 自動代碼生成器的實現(xiàn)代碼
本文通過實例代碼給大家介紹了基于Mybatis-plus 自動代碼生成器的相關知識，非常不錯，具有一定的參考借鑒價值,需要的朋友可以參考下
2018-05-05
Java部分序列化之關鍵字transient使用及說明
Java序列化將對象轉為字節(jié)序列用于存儲或傳輸,需實現(xiàn)Serializable接口,transient關鍵字可排除敏感字段或不可序列化對象,避免反序列化時恢復無效數(shù)據(jù)或泄露信息
2025-09-09

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

SpringBoot中Fat Jar的三種打包方式詳解

目錄

一、Spring Boot Maven/Gradle插件默認打包方式

1.1 基本原理

1.2 配置方式

1.3 打包結構分析

1.4 運行方式

1.5 高級配置

Gradle

1.6 優(yōu)缺點分析

1.7 適用場景

二、Maven Shade插件打包方式

2.1 基本原理

2.2 配置方式

2.3 打包結構分析

2.4 運行方式

2.5 高級配置

2.6 優(yōu)缺點分析

2.7 適用場景

三、Maven Assembly插件打包方式

3.1 基本原理

3.2 配置方式

3.3 自定義Assembly描述符

3.4 創(chuàng)建可執(zhí)行jar

3.5 打包結構分析

3.6 運行方式

3.7 優(yōu)缺點分析

3.8 適用場景

四、總結

相關文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

SpringBoot中Fat Jar的三種打包方式詳解

目錄

一、Spring Boot Maven/Gradle插件默認打包方式

1.1 基本原理

1.2 配置方式

1.3 打包結構分析

1.4 運行方式

1.5 高級配置

Gradle

1.6 優(yōu)缺點分析

1.7 適用場景

二、Maven Shade插件打包方式

2.1 基本原理

2.2 配置方式

2.3 打包結構分析

2.4 運行方式

2.5 高級配置

2.6 優(yōu)缺點分析

2.7 適用場景

三、Maven Assembly插件打包方式

3.1 基本原理

3.2 配置方式

3.3 自定義Assembly描述符

3.4 創(chuàng)建可執(zhí)行jar

3.5 打包結構分析

3.6 運行方式

3.7 優(yōu)缺點分析

3.8 適用場景

四、總結

相關文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

一、Spring Boot Maven/Gradle插件默認打包方式