Maven依赖中的scope详解

最新推荐文章于 2025-03-06 17:53:56 发布

余一

最新推荐文章于 2025-03-06 17:53:56 发布

阅读量924

点赞数 2

CC 4.0 BY-SA版权

分类专栏： Maven 文章标签： maven dependency scope 依赖传递

原文链接：https://blog.youkuaiyun.com/kimylrong/article/details/50353161

Maven 专栏收录该内容

4 篇文章

订阅专栏

本文深入解析Maven中依赖范围（scope）的概念，包括compile、test、runtime、provided和system等，阐述它们在项目编译、测试和运行过程中的作用，并通过实例说明不同scope在依赖传递中的行为。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Maven的一个哲学是惯例优于配置(Convention Over Configuration), Maven默认的依赖配置项中，scope的默认值是compile，项目中经常傻傻的分不清，直接默认了。今天梳理一下maven的scope。

scope的分类

compile

默认就是compile，什么都不配置也就是意味着compile。compile表示被依赖项目需要参与当前项目的编译，当然后续的测试，运行周期也参与其中，是一个比较强的依赖。打包的时候通常需要包含进去。

test

scope为test表示依赖项目仅仅参与测试相关的工作，包括测试代码的编译，执行。比较典型的如junit。

runtime

runntime表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已，说实话在终端的项目（非开源，企业内部系统）中，和compile区别不是很大。比较常见的如JSR×××的实现，对应的API jar是compile的，具体实现是runtime的，compile只需要知道接口就足够了。oracle jdbc驱动架包就是一个很好的例子，一般scope为runntime。另外runntime的依赖通常和optional搭配使用，optional为true。我可以用A实现，也可以用B实现。

provided

provided意味着打包的时候可以不用包进去，别的设施(Web Container)会提供。事实上该依赖理论上可以参与编译，测试，运行等周期。相当于compile，但是在打包阶段做了exclude的动作。

system

从参与度来说，也provided相同，不过被依赖项不会从maven仓库抓，而是从本地文件系统拿，一定需要配合systemPath属性使用。

scope的依赖传递

A–>B–>C。当前项目为A，A依赖于B，B依赖于C。知道B在A项目中的scope，那么怎么知道C在A中的scope呢？答案是：
当C是test或者provided时，C直接被丢弃，A不依赖C；
否则A依赖C，C的scope继承于B的scope。

下面是一张nexus画的图。

下面是针对上图对原博客作的补充:
图片中最左边一列表示项目A的pom.xml中, 依赖项目C的scope；
最上面一行表示项目C依赖jar包的scope；

下面的代码是项目C对jar包的依赖，包含test、compile、provided、runtime多个scope类型

<dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
        
        <dependency>
            <groupId>jstl</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>taglibs</groupId>
            <artifactId>standard</artifactId>
            <version>1.1.2</version>
            <scope>provided</scope>
        </dependency>
        
        <!-- mysql jdbc -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.9</version>
            <scope>runtime</scope>
        </dependency>
</dependencies>

下面我们将要讨论的是，当项目A对项目C的依赖scope发生变化的时候，项目A中传递依赖和依赖scope发生的变化。

<dependency>
      <groupId>com.zhou</groupId>
      <artifactId>mavenTest</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <scope>${scope}</scope>
</dependency>

项目A对项目C的scope为compile

传递依赖只有compile的jstl和runtime的mysql，而且scope和A项目pom中配置的scope一致。
项目A对项目C的scope为test
项目C对项目A的scope为provided

只有compile和runtime的包，依赖的scope被设置为provided
项目C对项目A的scope为runtime

同样compile 和runtime的包。而且传递依赖的scope都被设置为了runtime。