一次Maven版本冲突，才知道 Dependency Scope 的作用

ゝ一纸荒年。 2024-05-24 05:03 78阅读 0赞

本文记录一下遇到maven依赖版本冲突后的排查过程说明以及问题原因说明

## 背景 ##

最近加入了 Apache Dubbo 开源社区，成为了一名Dubbo Contributor。想看下谷歌提供的grpc协议在使用上与dubbo提供的grpc协议的区别，所以打算根据 [grpc github][] 基础教程跑一个示例，在引入相关依赖以及代码后进行编译，发现一处报错：

![请在此添加图片描述][format_png]

经过初步排查发现是依赖版本问题

![请在此添加图片描述][format_png 1]

## 疑问 ##

我不禁就有了疑问，我明明引入的grpc版本是1.54.0，为啥子编译完是1.31.1？

为了验证我的疑问是合理的，通过`mvn dependency:tree`命令以及版本对比，更加增加了我的疑惑。如下图，`grpc-netty-shaded`依赖中的`grpc-core`确确实实是1.54.0，为啥子就成了1.31.1了？无中生有？

![请在此添加图片描述][format_png 2]

## 排查过程 ##

起初我怀疑是dubbo-bom的问题，不会呀，dubbo-bom在父工程中以dependencyManagement形式存在，我没有引入依赖它是不会传递的呀？随即立马打消了这个疑问

![请在此添加图片描述][format_png 3]

然后开始没有目的的百度“maven版本冲突问题？” ，结果是没有任何头绪，只有`Maven Helper`插件帮忙解决冲突问题，但是我想知道的是**为什么会冲突**。

![请在此添加图片描述][format_png 4]

紧接着又去github上提了一个issue “为什么根据官方提供的依赖出现版本冲突问题？” ?

![请在此添加图片描述][format_png 5]

过了一天后看没人回答，想了想难道真的是dubbo bom问题？ 于是我注释了dubbo bom的依赖，就可以了！！！

这是为什么？我没有引入dubbo bom任何依赖呀？难道是这个scope导致的？

于是继续百度 “maven denpendency scope” ? ，这些结果要么没有对scope为import的说明，要么就是很含糊抽象，看上去跟我之前的理解一样。

![请在此添加图片描述][format_png 6]

由于百度的结果并不能解决我的问题，所以上[maven官网][maven]看了下对Dependency Scope的说明

![请在此添加图片描述][format_png 7]

最后定位问题所在。

## 问题存在的原因 ##

> scope为import是指依赖项将被`<dependencyManagement>`部分中的有效依赖项列表所**取代**。

这个说明非常具体，一下就打消了我所有的疑惑。因为dubbo-bom中存在`dubbo-rpc-grpc`依赖项，而其又有grpc的依赖

![请在此添加图片描述][format_png 8]

**根据官网上的说明，我在子工程中声明版本为1.54.0的grpc依赖项会被其所替代。**

所以出现了这个问题?

## 总结 ##

通过这次版本冲突问题，让我意识到我对maven的了解远远不够。平时只是对其使用，出现冲突直接解决，并不会去深究为什么。也是通过这次的问题让我对maven多了点了解，让我对解决问题的方式更加深刻：遇到问题不要上来就百度?，要学会分析、要学会在官网上寻找问题所在，要对一个知识有全面的了解。

## 示例依赖版本说明 ##

**dubbo-bom依赖如下**

xml

复制代码

`<dependency> <groupId>org.apache.dubbo</groupId> <artifactId>dubbo-bom</artifactId> <version>${dubbo.version}</version> <type>pom</type> <scope>import</scope> </dependency>`

**grpc依赖如下**

xml

复制代码

`<dependency> <groupId>io.grpc</groupId> <artifactId>grpc-netty-shaded</artifactId> <version>1.54.0</version> <scope>runtime</scope> </dependency> <dependency> <groupId>io.grpc</groupId> <artifactId>grpc-protobuf</artifactId> <version>1.54.0</version> </dependency> <dependency> <groupId>io.grpc</groupId> <artifactId>grpc-stub</artifactId> <version>1.54.0</version> </dependency> <dependency>  <groupId>org.apache.tomcat</groupId> <artifactId>annotations-api</artifactId> <version>6.0.53</version> <scope>provided</scope> </dependency>`

[grpc github]: https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2Fgrpc%2Fgrpc-java%2Fblob%2Fv1.54.x%2FREADME.md
[format_png]: https://img-blog.csdnimg.cn/img_convert/4654634b0d76883080c323c88ec2aee9.webp?x-oss-process=image/format,png
[format_png 1]: https://img-blog.csdnimg.cn/img_convert/f569687dcfa2086c57d16dbee6151942.webp?x-oss-process=image/format,png
[format_png 2]: https://img-blog.csdnimg.cn/img_convert/951816f06667b35c3e58dd47029abc6e.webp?x-oss-process=image/format,png
[format_png 3]: https://img-blog.csdnimg.cn/img_convert/ad923c3defc4e8d1c12c845e7e093297.webp?x-oss-process=image/format,png
[format_png 4]: https://img-blog.csdnimg.cn/img_convert/5206b9d1663ffeef26b4226681c642a7.webp?x-oss-process=image/format,png
[format_png 5]: https://img-blog.csdnimg.cn/img_convert/4de18ca672a8cffc9808264d529fd6c5.webp?x-oss-process=image/format,png
[format_png 6]: https://img-blog.csdnimg.cn/img_convert/4e0a976d1203284a256ccc8fae95c647.webp?x-oss-process=image/format,png
[maven]: https://link.juejin.cn/?target=https%3A%2F%2Fmaven.apache.org%2Fguides%2Fintroduction%2Fintroduction-to-dependency-mechanism.html%23Dependency_Management
[format_png 7]: https://img-blog.csdnimg.cn/img_convert/47d8bb13e115613995e7946712172c3c.webp?x-oss-process=image/format,png
[format_png 8]: https://img-blog.csdnimg.cn/img_convert/0e572fb01a000751b284fb3d6ada30cd.webp?x-oss-process=image/format,png