<think>我们正在讨论
Maven的
依赖管理，特别是如何排除传递性子
依赖。
根据用户的问题，他想了解在pom.xml中如何排除子
依赖（传递
依赖）。
在
Maven中，传递
依赖是指项目直接
依赖的库所
依赖的其他库。有时候这些传递
依赖可能会引起冲突，或者我们
不需要它们，这时就需要排除它们。
排除
依赖的方法是在<dependency>元素中使用<exclusions>和<exclusion>子元素来指定要排除的
依赖。
基本语法如下：
```xml
<dependency>
<groupId>group.id</groupId>
<artifactId>artifact-id</artifactId>
<version>version</version>
<exclusions>
<exclusion>
<groupId>unwanted.group</groupId>
<artifactId>unwanted-artifact</artifactId>
</exclusion>
<!-- 可以排除多个 -->
</exclusions>
</dependency>
```
注意：在<exclusion>中，我们只需要指定groupId和artifactId，
不需要指定版本，因为排除的是该
依赖传递过来的所有该artifact。
举个例子：假设我们
依赖了库A，而库A
依赖了库B（版本为1.0），但我们
不想引入库B，因为我们的项目已经直接
依赖了库B的2.0版本，或者库B有安全漏洞，或者我们根本用
不到它。那么我们就可以在
依赖A的时候排除B。
示例代码：
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>libraryA</artifactId>
<version>1.0</version>
<exclusions>
<exclusion>
<groupId>com.unwanted</groupId>
<artifactId>libraryB</artifactId>
</exclusion>
</exclusions>
</dependency>
```
这样，当引入libraryA时，libraryB就
不会被传递进来。
另外，我们也可以使用
Maven依赖插件来查看
依赖树，以便确定需要排除哪些
依赖。命令是：
```
mvn dependency:tree
```
这个命令会显示项目的
依赖树，从中可以看到传递
依赖的来源，从而帮助我们决定排除哪个
依赖。
引用[1]中提到了在Gradle中排除
依赖的方法（通过`exclude`），但用户的问题是关于
Maven的pom.xml，所以我们主要讲解
Maven的方式。
引用[3]中提到了Spring Boot的相关内容，虽然与
依赖管理有关，但并
不是直接关于排除传递
依赖的，因此我们仅参考其背景。
因此，针对用户的问题，我们给出在
Maven的pom.xml中排除传递
依赖的方法。
注意：排除
依赖可能会破坏
依赖库的功能，因此需要确保排除的
依赖确实是
不需要的或者由其他兼容版本替代。
相关问题：
1. 如何查看
Maven项目的
依赖树？
2. 在
Maven中，如何解决
依赖冲突？
3. 除了排除
依赖，还有哪些方法可以管理传递
依赖？
4.
Maven和Gradle在
依赖排除上有何异同？</think>### 如何在
Maven 的 pom.xml 中排除子
依赖（传递
依赖）
在
Maven 项目中排除传递
依赖（子
依赖）的方法如下：
#### 1. **基本排除语法**
在
依赖声明中添加 `<exclusions>` 块，指定要排除的
依赖坐标：
```xml
<dependency>
<groupId>主
依赖组</groupId>
<artifactId>主
依赖名</artifactId>
<version>主
依赖版本</version>
<exclusions>
<!-- 排除特定子
依赖 -->
<exclusion>
<groupId>要排除的组</groupId>
<artifactId>要排除的构件</artifactId>
</exclusion>
</exclusions>
</dependency>
```
> **注意**：排除
依赖只需指定 `groupId` 和 `artifactId`，
不需要版本号，因为排除的是该
依赖传递的所有版本。
#### 2. **实际示例**
排除 `spring-boot-starter-web` 传递的 `spring-boot-starter-logging`：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 3. **排除多个子
依赖**
在 `<exclusions>` 中添加多个 `<exclusion>`：
```xml
<exclusions>
<exclusion>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-annotations-api</artifactId>
</exclusion>
</exclusions>
```
#### 4. **
依赖树分析（定位需排除的
依赖）**
使用命令查看
依赖树，确定需要排除的
依赖路径：
```bash
mvn dependency:tree
```
输出示例：
```
[INFO] com.example:my-project:jar:1.0
[INFO] +- org.springframework.boot:spring-boot-starter-web:jar:2.7.0:compile
[INFO] | +- org.springframework.boot:spring-boot-starter-logging:jar:2.7.0:compile <!-- 需要排除的
依赖 -->
```
#### 5. **全局
依赖管理（推荐）**
在 `<dependencyManagement>` 中统一管理排除规则：
```xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.7.0</version>
<type>pom</type>
<scope>import</scope>
<exclusions>
<exclusion>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
</dependencyManagement>
```
#### 常见场景
1. **解决版本冲突**：当两个
依赖引入同一库的
不同版本时
2. **移除无用
依赖**：减少最终构建包大小
3. **替换实现**（如日志框架切换）：
```xml
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
```
> **重要提示**：排除
依赖可能导致库功能异常，需测试验证。优先考虑使用 `<dependencyManagement>` 统一版本管理[^1]。
---
### 相关问题
1. 如何查看
Maven 项目的完整
依赖树？
2. 排除
依赖后出现 `ClassNotFoundException` 该如何解决？
3.
Maven 的 `<dependencyManagement>` 和 `<dependencies>` 有何区别？
4. 如何在 Gradle 中排除传递
依赖（对比
Maven）？
5. Spring Boot 项目中如何统一管理第三方
依赖版本？
[^1]: 引用自
Maven 官方文档
依赖管理机制。
Maven排除依赖
本文介绍如何在Maven项目中使用pom.xml文件排除不需要的依赖jar包，通过使用mvndependency:tree命令来查看依赖树，并展示如何配置排除特定版本的Spring框架组件。
扫一扫
1327
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
