构建与依赖 / 系统课时
验证版本与环境信息
验证版本与环境信息
本节把“命令能运行”升级为可核对的环境验收。你会确认 Maven、JDK、操作系统和本地仓库的实际位置,并能判断终端是否误用了旧 Maven、旧 JDK 或其他目录中的可执行文件。
学习目标
- 用
mvn -v一次确认 Maven、Java 与操作系统信息。 - 查出 Maven 当前实际使用的本地仓库目录,而不是只凭默认路径猜测。
- 根据路径和版本差异定位“命令能运行但环境用错了”的问题。
读懂 mvn -v 的关键字段
先在项目目录之外执行一次版本检查,避免项目自己的 .mvn 配置干扰判断。示例按 Maven 3.10.0 与 JDK 21 编写,补丁号、安装路径和操作系统字段以你的机器为准。
mvn -v预期输出:
Apache Maven 3.10.0 (<HASH>)
Maven home: <PATH>
Java version: 21.0.<PATCH>, vendor: <VENDOR>, runtime: <PATH>
Default locale: <LOCALE>, platform encoding: UTF-8
OS name: "<OS>", version: "<VERSION>", arch: "<ARCH>", family: "<FAMILY>"验收时重点看三处。Maven home 应落在你计划使用的 Maven 安装目录;Java version 应符合项目或课程要求;runtime 应属于目标 JDK。若 java -version 是 21,但 mvn -v 显示 17,说明 Maven 启动时读取到的 Java 环境与当前 java 命令并不一致,需要检查 JAVA_HOME 和 Path 顺序。
查询实际本地仓库位置
默认情况下,本地仓库位于用户主目录的 .m2/repository,但团队可以在 settings.xml 中通过 localRepository 改到其他磁盘,所以不要只检查默认目录。使用 Maven Help Plugin 可以让 Maven直接返回当前生效值。
mvn help:evaluate -Dexpression=settings.localRepository -q -DforceStdout预期输出:
<PATH>/.m2/repositoryWindows 常见结果类似 C:\Users\<USER>\.m2\repository,macOS/Linux 常见结果类似 /home/<USER>/.m2/repository 或 /Users/<USER>/.m2/repository。如果这是第一次执行该插件,Maven 可能先联网下载插件及其依赖;下载完成后才会打印最终路径。
核对命令到底来自哪个安装目录
同一台开发机常同时存在系统包管理器安装、IDE 自带、手动解压和旧版本残留。只比较版本号不够,还要确认命令解析到哪个可执行文件。Windows 使用 where.exe,macOS/Linux 使用 which 或 which -a。
Windows:
where.exe java
where.exe mvn预期输出:
<PATH>\bin\java.exe
<PATH>\apache-maven-3.10.0\bin\mvn.cmdmacOS/Linux:
which -a java
which -a mvn预期输出:
<PATH>/bin/java
<PATH>/apache-maven-3.10.0/bin/mvn如果每个命令返回多个结果,第一行具有最高优先级。实际项目中最常见的问题不是“没有安装”,而是旧路径排在新路径前面,例如系统先找到 /usr/bin/mvn,而你以为正在使用 $HOME/tools/apache-maven-3.10.0/bin/mvn。
检查 settings.xml 是否改变了环境
Maven 的用户级配置文件默认位于用户主目录下的 .m2/settings.xml,全局配置则位于 Maven 安装目录的 conf/settings.xml。本地仓库、镜像、代理和服务器凭据都可能在这里改变默认行为,因此排查依赖下载问题时应确认“哪个配置生效”,而不是只看安装目录。
可以输出当前合并后的有效配置,再在结果中搜索 localRepository、mirrors 或 proxies。这个命令会把有效设置打印到终端,不会修改任何配置。
mvn help:effective-settings预期结果:
[INFO] BUILD SUCCESS命令成功时,终端会在结束前输出合并后的 <settings> 内容;具体 XML 取决于用户配置和全局配置。若只想确认仓库路径,优先使用上一节的 help:evaluate;只有在仓库、镜像或代理行为异常时,再检查完整有效设置。
建立一份可复查的环境基线
团队排查 Maven 问题时,至少记录 Maven 版本、Maven home、Java 版本、Java 运行时路径、操作系统与架构、本地仓库路径这六项。不要只发一句“我这里 Maven 能跑”,因为两个终端都能执行 mvn,背后仍可能使用不同 JDK、不同镜像和不同仓库。
如果版本与路径全部符合预期,但依赖仍下载失败,下一步应转向 settings.xml 中的镜像、代理与凭据;如果 mvn -v 本身就指向错误目录,则先修正环境变量和命令优先级,再继续排查项目构建。