Maven 依赖管理全面解析

目录

1. Maven 简介

2. 依赖的基本概念

依赖坐标

依赖范围

3. Maven 仓库

本地仓库

远程仓库

4. 依赖传递

5. 依赖冲突

6. 在 pom.xml 文件中管理依赖

基本依赖配置

依赖范围配置

依赖排除配置

依赖管理配置（）

---

1. Maven 简介

Maven 是一个强大的项目管理和构建自动化工具，广泛应用于 Java 项目。它提供了标准化的项目结构、依赖管理和构建流程，极大地提高了开发效率。依赖管理是 Maven 的核心功能之一，它允许开发者通过简单的配置来引入和管理项目所需的第三方库。

2. 依赖的基本概念

依赖坐标

Maven 使用一组坐标来唯一标识一个依赖，包括 groupId、artifactId、version，还可包含可选的 packaging 和 classifier。

• groupId：通常是公司或组织的域名倒写，用于区分不同的组织或项目组。例如，org.springframework 代表 Spring 框架所属的组织。
• artifactId：是项目或模块的名称，在 groupId 下具有唯一性。如 spring - core 是 Spring 框架的核心模块。
• version：指定依赖的版本号，Maven 依据此版本号从仓库获取相应的依赖。
• packaging：常见的有 jar（普通 Java 类库）、war（Web 应用）等，默认值为 jar。
• classifier：可选属性，用于区分同一 artifact 的不同构建版本，如带有 sources 分类器的 jar 文件可提供源代码。

依赖范围

不同的依赖在项目的不同阶段有不同的作用，Maven 定义了几种依赖范围：

• compile：默认范围，依赖在项目的编译、测试和运行阶段都需要。例如，项目使用 Spring 框架的核心库，在各个阶段都依赖这些库。
• test：只在测试阶段使用，如 JUnit 测试框架，仅用于编写和执行单元测试，项目实际运行时无需。
• provided：编译和测试阶段需要，但运行时由容器提供。例如，Servlet API，开发 Web 应用时用于编译和测试 Servlet 代码，部署到 Web 容器后，容器本身提供该 API。
• runtime：编译阶段不需要，但运行和测试阶段需要。如数据库驱动，项目代码编译时无需直接引用，但运行和测试时用于连接数据库。

3. Maven 仓库

本地仓库

Maven 会将从远程仓库下载的依赖存储在本地仓库中，默认位置是用户目录下的 .m2/repository 文件夹。当项目需要依赖时，Maven 先在本地仓库查找，避免重复下载。

远程仓库

• 中央仓库：Maven 默认的远程仓库，由 Sonatype 维护，包含大量常用的开源库。项目添加 Spring 框架依赖时，Maven 首先尝试从中央仓库获取。
• 私服：企业或组织内部搭建的仓库，用于存储内部开发的库或对外部库进行定制化管理，提高内部开发效率，控制依赖的安全性和版本。

4. 依赖传递

当项目 A 依赖项目 B，项目 B 又依赖项目 C 时，Maven 会自动处理这种依赖传递关系。例如，项目 A 依赖 Spring Boot Starter Web，该库又依赖 Spring Web 及其他库，Maven 会自动将 Spring Web 及其相关依赖下载到项目 A 的本地仓库，并根据依赖范围确定其在项目 A 中的使用方式。不过，依赖传递可能导致版本冲突问题。

5. 依赖冲突

项目的依赖树中出现同一个库的不同版本时会产生依赖冲突。例如，项目 A 直接依赖库 X 的版本 1.0，又通过依赖传递间接依赖库 X 的版本 2.0。Maven 默认选择离项目更近的依赖版本，开发者也可通过 <dependencyManagement> 标签手动管理和解决依赖冲突。

6. 在 pom.xml 文件中管理依赖

基本依赖配置

在 pom.xml 文件中，通过 <dependencies> 标签包含所有依赖，每个依赖使用 <dependency> 子标签配置。示例如下：

xml

<project><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>my - project</artifactId><version>1.0.0</version><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring - core</artifactId><version>5.3.28</version></dependency></dependencies>
</project>

依赖范围配置

结合不同的依赖范围，在 pom.xml 中的配置示例如下：

xml

<dependencies><!-- compile 范围 --><dependency><groupId>org.springframework</groupId><artifactId>spring - core</artifactId><version>5.3.28</version><!-- compile 是默认范围，可省略 --><!-- <scope>compile</scope> --></dependency><!-- test 范围 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><scope>test</scope></dependency><!-- provided 范围 --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet - api</artifactId><version>4.0.1</version><scope>provided</scope></dependency><!-- runtime 范围 --><dependency><groupId>mysql</groupId><artifactId>mysql - connector - java</artifactId><version>8.0.26</version><scope>runtime</scope></dependency>
</dependencies>

依赖排除配置

当依赖传递引入不需要的依赖时，可使用 <exclusions> 标签排除。例如，项目依赖 spring - boot - starter - web，但不想引入其中的 Tomcat：

xml

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring - boot - starter - web</artifactId><version>2.7.5</version><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring - boot - starter - tomcat</artifactId></exclusion></exclusions>
</dependency>

依赖管理配置（<dependencyManagement>）

通过 <dependencyManagement> 标签可统一管理项目中所有依赖的版本，避免版本混乱。示例如下：

收起

xml

<dependencyManagement><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring - core</artifactId><version>5.3.28</version></dependency></dependencies>
</dependencyManagement><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring - core</artifactId></dependency>
</dependencies>

在上述示例中，子模块可继承 <dependencyManagement> 中定义的版本，使整个项目的依赖管理更规范。