你兴冲冲导入了第一个 Spring Boot 项目,右下角开始疯狂下载几百个 jar 包,进度条转了好几分钟。别慌,这不是电脑中毒,是 Maven 在干活。这篇讲清它下载了什么、为什么要下载。
写个功能要用别人写好的库(比如操作 Excel 的工具类),这些库就是一个个 jar(Java Archive,Java 的压缩包格式,里面装的是编译好的代码)。
没有 Maven 时你得手动做:去官网下载 jar → 放进项目 → 右键加入依赖。你的库又依赖别的库,一层套一层,下错版本就报 ClassNotFoundException。这就是传说中的「Jar 地狱」。
地狱有多深?举个真实的账:一个 Spring MVC + MyBatis 的老项目,手动管 jar 要三十多个,还得版本配套。某个库升级 0.1,另外三个跟着要换,漏一个就是线上启动失败。2010 年前的 Java 程序员每天都在做这种拼图,直到构建工具把这活接管了。
Maven(读作「梅文」)是 Java 项目的管家,干两件事:
1. 管依赖:你只要在清单里写「我要用什么」,它自动下载全部连带依赖
2. 管构建:一键完成清理、编译、测试、打包
一个买菜类比:
~/.m2/repository)= 你家冰箱,下载过一次就存着,下次直接拿新建 Maven 项目(IDEA 里 New Project → 构建系统选 Maven),打开根目录的 pom.xml,在 <dependencies> 里加一段:
<dependency>
<groupId>org.junit.jupiter</groupId> <!-- 作者 namespace -->
<artifactId>junit-jupiter</artifactId> <!-- 库名 -->
<version>5.10.0</version> <!-- 版本号 -->
<scope>test</scope> <!-- 只在测试时用 -->
</dependency>
保存后右下角自动导入,本地仓库里就多了 junit 目录。三个坐标(groupId + artifactId + version)唯一定位一个 jar,像「省+市+门牌号」。
打开本地仓库逛一圈,你会发现目录结构和坐标严格对应:org/junit/jupiter/junit-jupiter/5.10.0/。所以坐标不只是「名字」,也是冰箱里的货架编号——传坐标等于直接定位到货架,快且不会拿错。
点一下刷新,Maven 跑了这五步:
1. 读 pom.xml,拿到你要的直接依赖
2. 解析每个依赖自己的 pom,挖出传递依赖(依赖的依赖,树状展开)
3. 检查本地仓库有没有,没有就去中央仓库下载
4. 版本冲突时按「最短路径优先」选一个(可用 <exclusion> 手动剔除)
5. 把整棵依赖树挂到项目 classpath 上,编译就能 import 了
scope 常用三个:compile 全程可用(默认)、test 只测试时可用、provided 编译要但运行时环境自带。
classpath(类路径,JVM 找类的搜索清单)是这出戏的主角:你 import 的每个类,JVM 都挨个翻 classpath 里的 jar 找。所谓「加依赖」,本质是往这份清单里添货架。以后报 ClassNotFoundException,第一反应就是「哪个 jar 没进 classpath」。
假设你引了 A 和 B 两个库:A 要 jackson 2.15,B 要 jackson 2.17。两棵子树在 jackson 这里撞车,Maven 按「最短路径优先」挑一个——离你近的赢。被淘汰的版本就消失了吗?不一定:如果 B 真的用了 2.17 才有的方法,运行时就炸 NoSuchMethodError。
排查三步走:
1. mvn dependency:tree -Dincludes=com.fasterxml.jackson.core 把 jackson 的来龙去脉打出来
2. 看清楚是谁带进来的旧版本
3. 在引入旧版的依赖里加 <exclusions> 剔掉它,或用 <dependencyManagement> 统一锁版本
Spring Boot 项目为什么很少遇到这种事?因为 parent(下面讲)已经把几百个常用库的版本测好、锁死了,这套版本表就是面试常说的 BOM(Bill of Materials,物料清单)。你自己引时不写 version,直接继承它的裁决。
依赖之外,pom 还是项目的户口本,扫一眼骨架:
<packaging>:打成 jar 还是 war,普通工程 jar、老式 Web 工程 war<parent>:继承一份父 pom,Spring Boot 项目第一行那个 spring-boot-starter-parent 就是来领版本表的<properties>:集中定义版本号变量,改一处全局生效<build>:插件配置,比如打可执行 jar 的 spring-boot-maven-plugin约定优于配置是 Maven 的世界观:源码在 src/main/java、测试在 src/test/java、资源在 src/main/resources——你不配置,它就按这套约定找。反着来当然可以配,但没人跟自己过不去。第一次见到「这目录结构怎么所有人长得都一样」,答案就在这。
命令行里 mvn clean package 是以后部署时的口头禅。Maven 把构建过程拆成三段生命周期(按顺序执行的阶段序列):
clean:删掉上次的产物目录,从零开始compile:把 src/main/java 编译成 classtest:跑 src/test 里的全部测试用例package:打成 jar 或 warinstall:把打好的包放进本地仓库,给别的项目用关键规则是执行后面的阶段会先把前面跑完:你敲 mvn install,它会依次 compile、test、package、install,一条龙。所以「测试挂了就打不出包」不是 bug 是设计——质量卡在流程里。
常用组合就两组:平时验证用 mvn clean compile,交付部署用 mvn clean package。看到 BUILD SUCCESS 才算数,红色的 BUILD FAILURE 上面几行必有原因。
顺带认识 target 目录:编译产物、测试报告、打出的 jar 全在这。它是「可以随时删掉重来」的目录——构建出问题,先 mvn clean 再说,一多半的玄学到此为止。
中央仓库在国外,第一次下载动辄几分钟。在 ~/.m2/settings.xml(没有就新建)里配镜像:
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
同一个超市,换了个近的门面,速度立刻起飞。
mirrorOf 填 central 只镜像中央仓库;填 * 是全接管。公司里通常还会给你一个私服地址(Nexus),原理一样:把「国外超市」换成「楼下仓库」,顺便存公司内部的包。
~/.m2/repository 里对应目录重下mvn dependency:tree 查冲突,exclusion 排掉旧的Settings → Build Tools → Maven 里对齐路径Settings → Maven → Local repository 改路径,别真让冰箱塞满系统盘lastUpdated 后缀的文件:下载失败的残影,删掉对应目录让它重下Maven 用一份 pom 清单自动管下载和构建;理解「中央仓库→本地冰箱→classpath」这条链,再记住 dependency:tree 这把查冲突的手术刀,右下角的进度条就再也不会吓到你。