Maven打包過程中排除特定依賴的完整指南
前言
在使用 Maven 構(gòu)建 Java 項目時，我們常常需要對項目的打包過程進行精細化控制，尤其是希望排除某些特定的依賴庫。這可能是為了減小最終構(gòu)建產(chǎn)物的體積、避免版本沖突，或者僅僅是為了滿足不同環(huán)境下的部署需求。
本文將詳細介紹如何在 Maven 打包過程中排除特定依賴，涵蓋多種常見插件和配置方式，幫助你靈活控制項目的打包內(nèi)容。
一、理解 Maven 的依賴作用域（Scope）
在深入討論排除依賴之前，先了解 Maven 中的依賴作用域是非常重要的。不同的作用域決定了依賴是否會被包含在構(gòu)建輸出中：
| Scope | 描述 |
|---|---|
| compile | 默認作用域，適用于所有階段（編譯、測試、運行） |
| provided | 編譯和測試階段可用，但不會被打包進最終輸出（如 Servlet API） |
| runtime | 運行和測試階段需要，但編譯不需要（如 JDBC 驅(qū)動） |
| test | 僅用于測試階段，不會被打包 |
| system | 類似于 provided，但必須顯式指定本地路徑 |
| import | 僅用于 <dependencyManagement> 中導入其他 POM 的依賴 |
最佳實踐建議：優(yōu)先使用合適的 scope 來控制依賴是否被打包，而不是通過插件強行剔除。
二、使用 Maven Shade Plugin 排除依賴
如果你使用的是 maven-shade-plugin 來構(gòu)建一個包含所有依賴的 fat jar（即 uber jar），可以通過 <excludes> 標簽來排除特定依賴。
示例配置
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.5.0</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<excludes>
<exclude>com.example:unwanted-library</exclude>
<exclude>org.slf4j:slf4j-simple</exclude>
</excludes>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.example.Main</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
說明：
<exclude>的格式為groupId:artifactId，可以精確到版本號。- 適合用于構(gòu)建包含多個模塊和依賴的單體 JAR 包。
三、使用 Maven Assembly Plugin 排除依賴
如果你使用 maven-assembly-plugin 來打包一個包含依賴的 zip/jar 包，也可以通過 <excludes> 來排除某些依賴。
示例配置
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>3.6.0</version>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
<archive>
<manifest>
<mainClass>com.example.Main</mainClass>
</manifest>
</archive>
<excludes>
<exclude>com.example:unwanted-library</exclude>
<exclude>org.slf4j:slf4j-api</exclude>
</excludes>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
提示：Assembly 插件還支持自定義 assembly.xml 文件，實現(xiàn)更細粒度的控制。
四、使用 Maven Jar Plugin 排除資源或類文件
默認的 maven-jar-plugin 不會把依賴打進 JAR 包中，但如果你有特殊需求（如手動管理 lib 目錄），可以用來排除某些資源或類文件。
示例配置（排除資源）
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.7.0</version>
<configuration>
<excludes>
<exclude>**/unwanted/**</exclude>
</excludes>
</configuration>
</plugin>
五、使用 Maven Dependency Plugin 清理依賴
如果你想在打包前主動清理某些依賴，可以使用 maven-dependency-plugin 來復制依賴并排除部分庫。
示例配置
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>3.6.0</version>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<outputDirectory>${project.build.directory}/lib</outputDirectory>
<overWriteReleases>false</overWriteReleases>
<overWriteSnapshots>false</overWriteSnapshots>
<overWriteIfNewer>true</overWriteIfNewer>
<excludes>
<exclude>com.example:unwanted-library</exclude>
</excludes>
</configuration>
</execution>
</executions>
</plugin>
此方法適合手動構(gòu)建 lib 目錄，并配合 shell 腳本或 Dockerfile 使用。
六、Docker 構(gòu)建中排除依賴（Maven + Docker）
如果你使用 Maven 構(gòu)建鏡像（如結(jié)合 Jib、Dockerfile 等），可以在構(gòu)建應(yīng)用 JAR 包時就排除依賴，再將其 COPY 到 Docker 鏡像中。
示例（結(jié)合 jib-maven-plugin）
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>jib-maven-plugin</artifactId>
<version>3.3.2</version>
<configuration>
<container>
<entrypoint>
<arg>java</arg>
<arg>-cp</arg>
<arg>/app/resources:/app/classes:/app/libs/*</arg>
<arg>com.example.Main</arg>
</entrypoint>
</container>
<extraDirectories>
<paths>
<path>
<from>src/main/resources</from>
<into>/app/resources</into>
</path>
</paths>
</extraDirectories>
</configuration>
</plugin>
在此示例中，你可以先通過其他方式控制哪些依賴被放入 /app/libs/。
七、使用<scope>顯式排除依賴
最簡單且推薦的方式是直接在 pom.xml 中設(shè)置依賴的作用域為 test 或 provided，這樣它們就不會被打包進最終輸出。
示例
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
Maven 會根據(jù)作用域自動決定是否將該依賴包含在構(gòu)建輸出中。
八、使用<optional>標記依賴為可選
如果你開發(fā)的是一個庫（library），并且某個依賴不是必需的，可以將其標記為 <optional>true</optional>，這樣引入你的庫的項目可以選擇是否包含這個依賴。
示例：
<dependency>
<groupId>com.example</groupId>
<artifactId>some-utils</artifactId>
<version>1.0.0</version>
<optional>true</optional>
</dependency>
注意：<optional> 不會影響當前項目的打包行為，而是影響下游項目的依賴管理。
九、使用<exclusion>排除傳遞性依賴
有時你想排除某個依賴的子依賴（transitive dependency），可以使用 <exclusions>。
示例：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>log4j-over-slf4j</artifactId>
</exclusion>
</exclusions>
</dependency>
這種方式非常適合解決依賴沖突或精簡依賴樹。
十、綜合建議與最佳實踐
| 場景 | 推薦做法 |
|---|---|
| 測試依賴不打包 | 設(shè)置 <scope>test</scope> |
| 容器已提供依賴（如 Tomcat、JDK） | 設(shè)置 <scope>provided</scope> |
| 某些依賴不想被打入最終 JAR/WAR | 使用 Shade / Assembly 插件配置 <excludes> |
| 排除某個依賴的子依賴 | 使用 <exclusions> 標簽 |
| 控制依賴是否傳遞給下游項目 | 使用 <optional>true</optional> |
| 構(gòu)建 lib 目錄時排除某些庫 | 使用 maven-dependency-plugin 的 <excludes> |
| 構(gòu)建 Docker 鏡像時排除依賴 | 結(jié)合上述方法先處理好 JAR 再 COPY |
總結(jié)
Maven 提供了多種靈活的方式來排除特定依賴，從簡單的 <scope> 到復雜的插件配置，開發(fā)者可以根據(jù)實際需求選擇最合適的方法。合理使用這些技巧不僅可以減小最終包的體積，還能有效避免依賴沖突問題，提高構(gòu)建效率和部署穩(wěn)定性。
常見問答
Q：我只想排除某個依賴的一個 jar 文件？
A：可以使用 <exclusion> 排除其子依賴，或者使用插件配置 <excludes>。
Q：為什么設(shè)置了<scope>provided</scope>依賴仍然被打包？
A：檢查是否被其他插件強制引入，例如 maven-shade-plugin。
Q：我想在 Spring Boot 項目中排除某些 starter 自帶的依賴怎么辦？
A：使用 <exclusions> 標簽，在對應(yīng)的 starter 依賴中聲明要排除的子依賴。
到此這篇關(guān)于Maven打包過程中排除特定依賴的完整指南的文章就介紹到這了,更多相關(guān)Maven排除特定依賴內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
在本篇文章里小編給大家整理了一篇關(guān)于java中使用map排序的實例講解內(nèi)容，有興趣的朋友們可以學習下。2020-12-12
這篇文章主要介紹了Java并發(fā)編程之對象的共享，介紹如何共享和發(fā)布對象，使它們被安全地由多個進程訪問。需要的小伙伴可以參考一下2022-04-04
Java Web開發(fā)防止多用戶重復登錄的完美解決方案
在web項目開發(fā)中，很多情況下都可以讓同一個賬號信息在不同的登錄入口登錄很多次，這樣子做的不是很完善。一般解決這種情況有兩種解決方案，小編呢主要以第二種方式給大家介紹具體的實現(xiàn)方法，對java web 防止多用戶重復登錄的解決方案感興趣的朋友一起看看吧2016-11-11
springboot Interceptor攔截器excludePathPatterns忽略失效
這篇文章主要介紹了springboot Interceptor攔截器excludePathPatterns忽略失效的問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-07-07
關(guān)于spring?boot使用?jdbc+mysql?連接的問題
這篇文章主要介紹了spring?boot使用?jdbc+mysql?連接,在這里mysql?8.x版本驅(qū)動包，要使用?com.mysql.cj.jdbc.Driver作為驅(qū)動類，文中給大家詳細介紹，需要的朋友可以參考下2022-03-03
Spring?boot?整合RabbitMQ實現(xiàn)通過RabbitMQ進行項目的連接
RabbitMQ是一個開源的AMQP實現(xiàn)，服務(wù)器端用Erlang語言編寫，支持多種客戶端，這篇文章主要介紹了Spring?boot?整合RabbitMQ實現(xiàn)通過RabbitMQ進行項目的連接,需要的朋友可以參考下2022-10-10
這篇文章主要為大家詳細介紹了java實現(xiàn)ATM取款項目的實現(xiàn)代碼，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-06-06
Condition 將 Object 監(jiān)視器方法(wait()、notify()和notifyAll()）分解成截然不同的對象，以便通過將這些對象與任意Lock實現(xiàn)組合使用，為每個對象提供多個等待 set（wait-set）2021-06-06
Spring?Boot?2.6.x整合Swagger啟動失敗報錯問題的完美解決辦法
這篇文章主要給大家介紹了關(guān)于Spring?Boot?2.6.x整合Swagger啟動失敗報錯問題的完美解決辦法,文中通過實例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2022-03-03
Volatile可以看做是輕量級的 Synchronized,它只保證了共享變量的可見性,下面這篇文章主要給大家介紹了關(guān)于Java基礎(chǔ)面試題之volatile的相關(guān)資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2022-06-06