必须安装JDK(非JRE)并正确配置JAVA_HOME和PATH,确保javac与java版本一致且可调用;Maven版本需与JDK版本兼容,否则构建失败。

使用 Maven 前,必须确保 Java 运行环境已正确安装并配置,因为 Maven 本身是用 Java 编写的,其所有命令(如 mvn compile、mvn package)都依赖 JVM 才能执行。没有可用的 JDK,Maven 将无法启动。
必须安装 JDK(不是 JRE)
Maven 构建过程涉及编译源码、运行插件、执行测试等操作,这些都需要 Java 编译器(javac)和运行时支持。JRE 只含运行环境,不含编译工具,因此不能满足 Maven 要求。
- 推荐使用 JDK 8 或更高版本(Maven 3.6.3+ 官方支持 JDK 11/17;Maven 4.x 已要求 JDK 17+)
- 可通过终端运行
javac -version和java -version验证是否安装了 JDK(二者版本号应一致或兼容) - 注意:仅设置
JAVA_HOME指向 JRE 目录会导致mvn报错 “The JAVA_HOME environment variable is not defined correctly”
JAVA_HOME 环境变量必须正确配置
Maven 启动脚本(mvn 或 mvn.bat)会优先读取 JAVA_HOME 来定位 Java 安装路径。若未设置或指向错误,Maven 会尝试从系统 PATH 中查找 java,但可能版本不匹配或缺失 javac。
- Windows 示例:
set JAVA_HOME=C:\Program Files\Java\jdk-17.0.2 -
macOS / Linux 示例:
export JAVA_HOME=$(/usr/libexec/java_home -v 17)(推荐用java_home命令自动定位) - 验证方式:在终端输入
echo $JAVA_HOME(Linux/macOS)或echo %JAVA_HOME%(Windows),确认输出为 JDK 根目录
PATH 中需包含 %JAVA_HOME%\bin(Windows)或 $JAVA_HOME/bin(macOS/Linux)
确保 java 和 javac 命令可在任意目录下直接调用,这是 Maven 内部调用 Java 工具链的前提。
立即学习“Java免费学习笔记(深入)”;
- Windows:将
%JAVA_HOME%\bin添加到系统 PATH - macOS/Linux:在
~/.zshrc或~/.bash_profile中添加export PATH=$JAVA_HOME/bin:$PATH - 配置后重启终端,再执行
which java和which javac,确认路径指向 JDK 的 bin 目录
Maven 版本与 Java 版本需兼容
不同 Maven 版本对 Java 有明确最低要求,强行混用会导致构建失败或插件异常。例如:
- Maven 3.5.x 最低要求 JDK 8,但不完全支持 JDK 17 的新特性(如密封类)
- Maven 3.9.0+ 正式支持 JDK 21(LTS),但部分老插件可能尚未适配
- 建议查阅 Maven 官方 Requirements 页面,按实际 JDK 版本选择对应 Maven 版本
Java 是 Maven 的底层支撑,不是可选依赖——它决定了你能用什么语法写代码、哪些插件能正常工作、甚至整个项目的生命周期能否顺利执行。环境没配好,连 mvn -v 都会失败,更别说构建项目了。










