Maven项目中依赖传递优先级问题的实践 & dependencyManagement标签的使用

末蓝、 2023-01-14 01:39 213阅读 0赞

# Maven项目中依赖传递优先级问题的实践 #

突然说道maven的jar包依赖问题，原因是某个安全级别较高的客户现场扫描到了我们产品项目的jar包存在漏洞，需要升级jar包版本，我的实践由此展开

## 查看项目的完整依赖树 ##

要升级jar包版本，首先要看到当前项目的jar包版本

执行`mvn dependency:tree`查看项目的完整依赖树

我是在IDEA中使用Maven管理工具 工具栏中的Execute Maven Goal，如下图所示:  
![在这里插入图片描述][202104191634111.png]  
点击打开，输入Maven命令，特殊说明：在windows的cmd中执行命令，需要在最前面加上mvn，而在这里不需要，如下图所示：  
![在这里插入图片描述][20210419163255609.png]  
可以看到控制台输出的树形依赖结构，这里给出示例：

pilafs-MacBook-Pro:content-admin pilaf$ mvn dependency:tree
    [INFO] Scanning for projects...
    [INFO] 
    [INFO] ------------------< com.**:content-admin >-------------------
    [INFO] Building content-admin 1.0-SNAPSHOT
    [INFO] --------------------------------[ jar ]---------------------------------
    [INFO] 
    [INFO] --- maven-dependency-plugin:3.1.1:tree (default-cli) @ content-admin ---
    [INFO] com.demo:content-admin:jar:1.0-SNAPSHOT
    [INFO] +- com.demo:content-api:jar:1.0-SNAPSHOT:compile
    [INFO] +- com.demo:content-common:jar:1.0-SNAPSHOT:compile
    [INFO] |  +- org.apache.httpcomponents:httpclient:jar:4.5.8:compile
    [INFO] |  |  \- org.apache.httpcomponents:httpcore:jar:4.4.11:compile
    [INFO] |  \- org.apache.httpcomponents:httpmime:jar:4.5.8:compile
    [INFO] +- org.springframework.boot:spring-boot-starter-test:jar:2.1.4.RELEASE:test
    [INFO] |  +- org.springframework.boot:spring-boot-test:jar:2.1.4.RELEASE:test
    [INFO] |  +- org.springframework.boot:spring-boot-test-autoconfigure:jar:2.1.4.RELEASE:test
    [INFO] |  +- com.jayway.jsonpath:json-path:jar:2.4.0:test
    [INFO] |  |  \- net.minidev:json-smart:jar:2.3:test
    [INFO] |  |     \- net.minidev:accessors-smart:jar:1.2:test
    [INFO] |  |        \- org.ow2.asm:asm:jar:5.0.4:test
    [INFO] |  +- org.assertj:assertj-core:jar:3.11.1:test
    [INFO] |  +- org.mockito:mockito-core:jar:2.23.4:test
    [INFO] |  |  +- net.bytebuddy:byte-buddy:jar:1.9.12:test
    [INFO] |  |  +- net.bytebuddy:byte-buddy-agent:jar:1.9.12:test
    [INFO] |  |  \- org.objenesis:objenesis:jar:2.6:test
    [INFO] |  +- org.hamcrest:hamcrest-core:jar:1.3:compile
    [INFO] |  +- org.hamcrest:hamcrest-library:jar:1.3:test
    [INFO] |  +- org.skyscreamer:jsonassert:jar:1.5.0:test
    [INFO] |  |  \- com.vaadin.external.google:android-json:jar:0.0.20131108.vaadin1:test
    [INFO] |  +- org.springframework:spring-core:jar:5.1.6.RELEASE:compile
    [INFO] |  |  \- org.springframework:spring-jcl:jar:5.1.6.RELEASE:compile
    [INFO] |  +- org.springframework:spring-test:jar:5.1.6.RELEASE:test
    [INFO] |  \- org.xmlunit:xmlunit-core:jar:2.6.2:test
    [INFO] +- com.h2database:h2:jar:1.4.199:runtime
    [INFO] \- mysql:mysql-connector-java:jar:5.1.46:runtime
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  2.431 s
    [INFO] Finished at: 2019-07-22T14:29:55+08:00
    [INFO] ------------------------------------------------------------------------

然后使找到要升级版本的jar包都被谁引用了

> org.springframework.boot:spring-boot-starter-web:jar

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70]  
可以看到是springboot的jar引用了这个目标jar，而我们的项目又引用了springboot的jar包。

## 升级jar包版本 ##

现在需要想办法把目标jar的版本升级到指定版本  
![在这里插入图片描述][20210419170225877.png]

于是现在直接在项目中指定引用jackson-databind的版本

<dependency>
          <groupId>com.fasterxml.jackson.core</groupId>
          <artifactId>jackson-databind</artifactId>
          <version>2.10.3</version>
        </dependency>

重新build项目后，再查看`jackson-databind`jar包的依赖情况

## 查看某个jar包的依赖情况 ##

查看依赖树中包含某个groupId和artifactId的依赖链（注意-Dincludes后面是等于号）  
`mvn dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind:`  
![在这里插入图片描述][20210419165803375.png]

> dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind:

### 引用jar包依赖传递 ###

之前的依赖情况如下图  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70 1]

### 直接引用jar包 ###

现在的依赖情况如图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70 2]

**到此问题解决**

**参考**  
[maven项目查看依赖树][maven]  
[Idea查看Maven依赖树][Idea_Maven]

--------------------

# dependencyManagement标签的使用 #

**dependencyManagement使用简介**

Maven中的dependencyManagement元素提供了一种管理依赖版本号的方式。在dependencyManagement元素中声明所依赖的jar包的版本号等信息，那么所有子项目再次引入此依赖jar包时则无需显式的列出版本号。Maven会沿着父子层级向上寻找拥有dependencyManagement 元素的项目，然后使用它指定的版本号。

举例  
在父项目的POM.xml中配置：

<dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-web</artifactId>
                    <version>1.2.3.RELEASE</version>
                </dependency>
            </dependencies>
        </dependencyManagement>

此配置即生命了spring-boot的版本信息。

子项目则无需指定版本信息：

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

**使用优点**  
如果有多个子项目都引用同一样依赖，则可以避免在每个使用的子项目里都声明一个版本号。当想升级或切换到另一个版本时，只需要在顶层父容器里更新，而不需要逐个修改子项目；另外如果某个子项目需要另外的一个版本，只需要声明version即可。

**注意事项**  
dependencyManagement中定义的只是依赖的声明，并不实现引入，因此子项目需要显式的声明需要用的依赖。

**参考**  
[dependencyManagement使用简介][dependencyManagement]

[Maven实战— dependencies与dependencyManagement的区别][Maven_ dependencies_dependencyManagement]

[Maven中依赖的优先级问题][Maven]

[Maven传递依赖的坑：父pom中dependencyManagement版本优先级高于传递依赖版本][Maven_pom_dependencyManagement]

[202104191634111.png]: /images/20221022/46db4da0e4e040e9b1b4ef3208fda6b0.png
[20210419163255609.png]: /images/20221022/1056a783389f4ca783aa2f47ba2ae392.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70]: /images/20221022/4dd1aa71cb0141e996eefcb66204b7a2.png
[20210419170225877.png]: /images/20221022/701f57a7c0de4ed8845e576172b341c6.png
[20210419165803375.png]: /images/20221022/15345e819afd48949dd69ab060ae861d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70 1]: /images/20221022/82185453dc71424dbee201ee95d2ccca.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjA2MDEw_size_16_color_FFFFFF_t_70 2]: /images/20221022/53de195a56a440268293c6d540ae6ee7.png
[maven]: https://blog.csdn.net/lzufeng/article/details/96857504
[Idea_Maven]: https://blog.csdn.net/u013217730/article/details/105814033
[dependencyManagement]: https://blog.csdn.net/weixin_42114097/article/details/81391024
[Maven_ dependencies_dependencyManagement]: https://www.cnblogs.com/feibazhf/p/7886617.html
[Maven]: https://blog.csdn.net/qq_42799615/article/details/105585427
[Maven_pom_dependencyManagement]: https://www.cnblogs.com/grey-wolf/p/10395153.html