Maven依赖排除（exclusion），查看依赖树（mvn dependency:tree），分析依赖项（mvn dependency:analyze）_maven exclusions

Maven 依赖排除

Maven依赖排除，怎么做？

在Maven项目中，如果你想排除某个依赖项的传递依赖（transitive dependency），即某个依赖通过其他依赖引入但你不希望它被包含在项目构建中，你可以直接在相关的<dependency>元素内部添加一个<exclusions>子元素，并在其中定义<exclusion>元素来指定要排除的依赖。下面是一个基本示例：

<dependencies>
  <!-- 假设你的项目直接依赖于 artifactId 为 'dependency-A' 的项目 -->
  <dependency>
    <groupId>com.example.group</groupId>
    <artifactId>dependency-A</artifactId>
    <version>1.0.0</version>

    <!-- 依赖A又依赖了 artifactId 为 'dependency-C' 的项目，但我们想排除这个传递依赖 -->
    <exclusions>
      <exclusion>
        <groupId>com.example.group</groupId>
        <artifactId>dependency-C</artifactId>
      </exclusion>
    </exclusions>
  </dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

在这个例子中，dependency-A 可能会带来 dependency-C 的传递依赖，但通过上述配置，我们明确地告诉 Maven 在处理 dependency-A 的依赖时不要引入 dependency-C。

完整的 <exclusion> 标签结构包括：

• <groupId>：要排除的依赖的组织ID。
• <artifactId>：要排除的依赖的工件ID。

如果你不确定哪些依赖是传递进来的，可以通过运行 mvn dependency:tree 命令查看依赖树，从而找到需要排除的具体依赖。此外，还可以结合使用 mvn dependency:analyze 命令来分析项目中未使用的直接和间接依赖项。

Maven 查看依赖树

在 Maven 中，查看项目的依赖树是一个常用且重要的功能，可以帮助开发者了解项目所依赖的所有库及其版本，以及它们是如何通过直接或间接引用层层嵌套的。依赖树能够展示每个依赖项的来源，这对于解决版本冲突、管理依赖关系以及优化构建过程非常有用。

命令行方式：
要在 Maven 项目中查看依赖树，可以通过命令行工具在项目根目录下运行以下命令：

mvn dependency:tree
1

这条命令会触发 Maven 执行 dependency:tree 目标，它会递归地解析并显示所有依赖项的层级关系。通常输出的结果会按照模块化结构展现，每一层依赖都会缩进表示其层次深度。

IntelliJ IDEA 中查看：
如果你使用的是 IntelliJ IDEA 开发工具，也有内置或者第三方插件的方式来查看依赖树：

1. 内置视图：

   • 在 IntelliJ IDEA 中，可以通过 View -> Tool Windows -> Maven Projects 打开 Maven 面板。
   • 在 Maven 面板中找到你的项目和模块，展开 Dependencies 节点，这里会显示项目的直接依赖。
   • 若要查看完整的依赖树结构，可以在 Maven 面板中找到 Plugins -> org.apache.maven.plugins:maven-dependency-plugin，点击 dependency:tree 运行目标。

2. Maven Helper 插件：

   • 安装名为 Maven Helper 的第三方插件，这将提供更加丰富的依赖分析功能。
   • 在 pom.xml 文件中可以直接查看依赖关系，包括冲突和排除的依赖项。

通过这些方法，你可以清晰地看到项目的整个依赖结构，包括每个依赖的groupId、artifactId、version以及scope（作用域）等信息。当存在版本冲突时，还可以快速定位冲突源并进行相应的调整。

Maven 分析未使用的直接和间接依赖项

在Maven项目中要分析并找出未使用的直接和间接依赖项，可以使用Maven的dependency插件的analyze目标。以下是如何进行操作的步骤：

# 分析项目中的依赖关系，包括未使用的直接和间接依赖
mvn dependency:analyze

# 输出会显示：
# - 项目中直接依赖但是未使用的依赖项（ Unused declared dependencies found）
# - 项目中直接或间接依赖但在编译或测试阶段确实用到的依赖项（ Used undeclared dependencies found）
# 这可以帮助识别出哪些依赖是可以安全移除的

# 如果希望看到更详细的信息，可以加上 `-Dverbose` 参数
mvn dependency:analyze -Dverbose
1
2
3
4
5
6
7
8
9
10

此外，配合dependency:tree命令可以查看整个依赖树，以直观地了解所有直接和间接依赖：

# 显示项目的完整依赖树，包括直接和间接依赖
mvn dependency:tree
1
2

结合这两个命令的结果，您可以更加准确地判断哪些依赖项是冗余的或者未被实际使用的，从而考虑在 pom.xml 文件中移除它们。

请注意，在实际项目中，有些依赖可能是由于框架内部使用或者未来扩展而存在的，即使看似未被直接引用也有可能是必要的，请谨慎对待分析结果并确保理解每个依赖项的作用之后再决定是否移除。