Maven - 依赖的生命周期详解

唐叔在学习

已于 2025-08-03 21:58:48 修改

阅读量438

点赞数 8

CC 4.0 BY-SA版权

分类专栏： # 唐叔的Java实践文章标签： maven java java项目构建依赖传递 pom文件详解

于 2025-08-03 21:06:47 首次发布

本文链接：https://blog.csdn.net/Tang_is_learning/article/details/149885696

唐叔的Java实践专栏收录该内容

8 篇文章

订阅专栏

作者：唐叔在学习
专栏：唐叔的Java实践
标签：Maven依赖管理、Java项目构建、依赖传递性、Spring Boot依赖、Maven最佳实践、项目构建工具、依赖冲突解决、POM文件详解

文章目录

一、开篇

各位CSDN的小伙伴们好，我是你们的老朋友唐叔！今天咱们来聊聊Java开发中那个让人又爱又恨的家伙——Maven。作为Apache旗下的顶级项目，Maven早已成为Java生态中不可或缺的构建工具。据最新统计，超过78%的Java项目都在使用Maven进行依赖管理！

但很多小伙伴对Maven的依赖机制一知半解，经常遇到诸如：

“明明加了依赖，为什么ClassNotFound？”
“这个jar包哪来的？我的pom里没声明啊！”
“为什么本地运行正常，打包就报错？”

今天唐叔就带大家彻底搞懂Maven依赖的生命周期，让你从此告别依赖地狱！

二、Maven依赖生命周期

2.1 依赖声明阶段：POM文件的艺术

在Maven的世界里，一切依赖都始于pom.xml。这个看似简单的XML文件，实则暗藏玄机。来看个Spring Boot项目的经典依赖声明：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.7.0</version>
    <scope>compile</scope>
</dependency>

这里包含四个关键要素：

groupId：组织标识（如org.springframework.boot）
artifactId：项目标识（如spring-boot-starter-web）
version：版本号（强烈建议使用明确版本）
scope：依赖范围（compile/runtime/test等）

唐叔小贴士：现在流行用Spring Boot的starter系列，它们其实是精心设计的"依赖包套餐"，比如spring-boot-starter-web就自动包含了Spring MVC、Tomcat等常用组件。

2.2 依赖解析阶段：Maven仓库的寻宝游戏

当你执行mvn compile时，Maven会开启一场跨越本地仓库、中央仓库、私服的寻宝之旅：

本地仓库：默认在~/.m2/repository，优先查找
中央仓库：repo.maven.apache.org，Maven官方维护
私服仓库：公司内部搭建的Nexus/Artifactory
镜像仓库：阿里云等提供的国内镜像（推荐配置）

热点SEO技巧：国内开发者强烈建议配置阿里云镜像，速度提升10倍不止！在settings.xml中加入：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

2.3 依赖传递性：你的依赖的依赖的依赖…

这是Maven最强大的特性，也是最容易出问题的点！比如你引入了spring-boot-starter-web，它会自动带来：

spring-boot-starter
spring-core
jackson-databind
tomcat-embed-core
…（共20+个传递依赖）

唐叔划重点：可以用mvn dependency:tree查看完整的依赖树，这是排查冲突的利器！

2.4 依赖范围（Scope）：不同阶段的不同需求

Maven定义了6种依赖范围，掌握它们能显著优化构建：

Scope	编译期	测试期	运行期	典型示例
compile	√	√	√	spring-core
provided	√	√	×	servlet-api
runtime	×	√	√	JDBC驱动
test	×	√	×	JUnit
system	√	√	×	本地系统路径的JAR
import	-	-	-	dependencyManagement

实战场景：开发Spring Boot应用时，打包成可执行JAR不需要包含Tomcat（因为内嵌了），但如果是WAR包部署到外部Tomcat，就需要把Tomcat依赖设为provided。

2.5 依赖调解：当冲突不可避免时…

当多个传递依赖引入不同版本时，Maven有两个调解原则：

最短路径优先：A→B→C→D(1.0) vs A→E→D(2.0) → 选择D(2.0)
先声明优先：在pom中先声明的依赖优先

冲突解决方案：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.1</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
        </exclusion>
    </exclusions>
</dependency>

三、高级技巧

3.1 BOM管理：统一版本的神器

Spring Cloud等大型项目都采用BOM(Bill of Materials)管理依赖版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2021.0.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 可选依赖（optional）与排除依赖（exclusion）

optional=true：表示该依赖不会被传递
exclusion：主动排除特定的传递依赖

3.3 依赖分类标签

<dependencies>
    <!-- 核心功能 -->
    <dependency>...</dependency>

    <!-- 数据库相关 -->
    <dependency>...</dependency>

    <!-- 测试相关 -->
    <dependency>...</dependency>
</dependencies>