Maven中的<scope>元素使用解讀
更新時間：2025年09月03日 14:49:44 作者：minh_coo
Maven的<scope>控制依賴范圍和生命周期,影響編譯、測試、運(yùn)行階段的可見性及打包,常見類型包括compile、provided、runtime等,用于管理依賴傳遞與沖突解決,如使用exclusions排除沖突
Maven的<scope>元素
概述
在 Maven 中，<scope> 元素用于控制依賴項的作用范圍和生命周期，即定義依賴項在項目的編譯、測試、運(yùn)行等階段的可見性，以及是否會被打包到最終產(chǎn)物中。
正確使用 <scope> 可以幫助我們優(yōu)化項目的構(gòu)建過程，減少不必要的依賴沖突，并提高構(gòu)建效率。
常見的<scope>取值及其含義
| scope | 作用范圍 | 場景示例 |
|---|---|---|
| compile | 默認(rèn)值。覆蓋編譯（compile）、測試（test）、運(yùn)行（runtime）所有階段，依賴會被直接包含到項目的 classpath 中，且會隨著項目打包（如 JAR/WAR）一起發(fā)布。 | 大多數(shù)業(yè)務(wù)依賴（如 Spring、Jackson 等）默認(rèn)使用此范圍 |
| provided | 僅在編譯（compile）和測試（test）階段有效，運(yùn)行（runtime）階段由外部環(huán)境（如應(yīng)用服務(wù)器）提供依賴，依賴不會被打包到項目產(chǎn)物中（因為運(yùn)行時由外部提供）。 | 容器提供的依賴：Servlet API（如 javax.servlet:javax.servlet-api） |
| runtime | 在測試（test）和運(yùn)行（runtime）階段有效，編譯（compile）階段不可用。 | JDBC 驅(qū)動（如 mysql:mysql-connector-java） |
| test | 僅在測試（test）階段有效（包括測試代碼的編譯和運(yùn)行），依賴不會被打包到最終產(chǎn)物中，也不會影響主代碼的運(yùn)行。 | 測試框架（如 JUnit、Mockito） |
| system | 與 provided 類似（僅編譯和測試階段有效），但依賴需要顯式指定本地文件路徑（非 Maven 倉庫），通過 <systemPath> 手動指定依賴的本地路徑。 | 不推薦使用，Maven 3.0 后已標(biāo)記為過時，建議改用 provided 或自定義倉庫 |
| import | 在 <dependencyManagement> 中使用。僅用于導(dǎo)入其他 POM 的 <dependencyManagement> 依賴配置，不會實際添加依賴到當(dāng)前項目，而是將目標(biāo) POM 的依賴管理規(guī)則合并到當(dāng)前項目的依賴管理中。 | 導(dǎo)入 Spring Boot 的 spring-boot-dependencies |
依賴傳遞性
Maven 依賴的傳遞性會受 <scope> 影響。
假設(shè) A → B → C，即 A 依賴 B，B 依賴 C：
- compile：C 會傳遞給 A（A 的 compile 范圍）
- runtime：C 會傳遞給 A（A 的 runtime 范圍）
- test / provided：C 不會傳遞給 A（僅 B 自己需要）
依賴沖突
當(dāng)多個依賴項引入相同的依賴，這時就可能出現(xiàn)版本沖突。
如：在projectA引入B依賴，B依賴又引入C依賴（版本1.0），假設(shè)這時projectA再引入D依賴，且D依賴也引入C依賴（版本2.0）。這時就會出現(xiàn)依賴沖突。
沖突解決原則
1、就近原則
A --> B --> C（版本1.0）
A --> C（版本2.0）
這時會引入2.0的C
2、第一聲明者原則
A -> B -> C（版本1.0）
A -> D -> C（版本2.0）
這時會引入1.0的C
解決方案
使用<exclusions> 標(biāo)簽排除沖突的依賴，只保留一個依賴。
如：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
<exclusions>
<exclusion>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator</artifactId>
</exclusion>
</exclusions>
</dependency>
總結(jié)
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關(guān)文章
Spring Boot 中的 Spring Cloud Feign的原
Spring Cloud Feign 是 Spring Cloud 中的一個組件，它可以幫助我們實現(xiàn)聲明式的 REST 客戶，這篇文章主要介紹了Spring Boot 中的 Spring Cloud Feign,需要的朋友可以參考下2023-07-07
這篇文章主要介紹了Mybatis-Plus實現(xiàn)一個SQL攔截器,通過使用SQL攔截器，開發(fā)人員可以在執(zhí)行SQL語句之前或之后對其進(jìn)行修改或記錄，從而更好地控制和優(yōu)化數(shù)據(jù)庫操作，對Mybatis-Plus?SQL攔截器相關(guān)知識感興趣的朋友一起看看吧2023-05-05
詳解Spring Boot 項目啟動時執(zhí)行特定方法
這篇文章主要介紹了詳解Spring Boot 項目啟動時執(zhí)行特定方法，Springboot給我們提供了兩種“開機(jī)啟動”某些方法的方式：ApplicationRunner和CommandLineRunner。感興趣的小伙伴們可以參考一下2018-06-06
這篇文章主要介紹了Java編程實現(xiàn)暴力破解WIFI密碼的方法,結(jié)合具體實例形式分析了java暴力破解WiFi密碼的原理、操作步驟、實現(xiàn)技巧與相關(guān)注意事項,需要的朋友可以參考下2018-12-12
Java?List過濾的多種方法及實戰(zhàn)應(yīng)用小結(jié)
本文深入探討了Java List過濾的多種方法及實戰(zhàn)應(yīng)用小結(jié),涉及了使用Collection接口的removeIf方法移除不滿足條件的元素,并分析了流API在并行操作中的優(yōu)勢,感興趣的朋友跟隨小編一起看看吧2025-08-08
新手小白入門必學(xué)JAVA面向?qū)ο笾鄳B(tài)
說到多態(tài),一定離不開其它兩大特性:封裝和繼承,下面這篇文章主要給大家介紹了關(guān)于新手小白入門必學(xué)JAVA面向?qū)ο笾鄳B(tài)的相關(guān)資料,文中通過實例代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-02-02
單機(jī)安裝主要用于程序邏輯調(diào)試。安裝步驟基本通分布式安裝，包括環(huán)境變量，主要Hadoop配置文件，SSH配置等,需要的朋友可以參考下2012-11-11
Mybatis SQL日志如何轉(zhuǎn)換為可執(zhí)行sql
這篇文章主要介紹了Mybatis SQL日志如何轉(zhuǎn)換為可執(zhí)行sql問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-09-09
這篇文章主要為大家詳細(xì)介紹了java版數(shù)獨游戲的核心算法，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-12-12
Java實現(xiàn)導(dǎo)出word表格的示例詳解
這篇文章主要為大家詳細(xì)介紹了如何利用Java語言導(dǎo)出word表格功能，文中的示例代碼講解詳細(xì)，具有一定的借鑒價值，需要的小伙伴可以參考一下2022-12-12