自 maven 3.5.4 起，只要系统 path 中可直接调用 java 命令，maven 即可自动定位 jdk 运行时，无需显式设置 java_home；但为确保构建稳定性与环境可重现性，生产环境仍强烈推荐显式配置。
自 maven 3.5.4 起，只要系统 path 中可直接调用 java 命令，maven 即可自动定位 jdk 运行时，无需显式设置 java_home；但为确保构建稳定性与环境可重现性，生产环境仍强烈推荐显式配置。
Apache Maven 自 3.5.4 版本（2018 年 10 月发布）起，对 Java 运行时的发现机制进行了重要升级：不再依赖 JAVA_HOME 环境变量作为唯一入口，转而优先通过系统 PATH 查找可用的 java 可执行文件。这一变更源于 Maven 内部启动脚本（mvn / mvn.cmd）和 Launcher 类的重构，使其具备了更智能的 JDK 探测能力。
✅ 工作原理简析
Maven 启动时按以下顺序尝试定位 Java 运行时：
- 检查 java 是否在 PATH 中可用（如 which java 或 where java），并调用 java -version 验证；
- 若成功，直接使用该 java 启动 JVM，并通过 System.getProperty("java.home") 获取其 jre/ 或 jre 目录（即运行时 home）；
- 仅当 java 不在 PATH 中时，才回退至检查 JAVA_HOME 变量，并尝试 $JAVA_HOME/bin/java；
- 若两者均失败，则报错 The JAVA_HOME environment variable is not defined correctly...。
这解释了为何 mvn -version 在 Maven ≥3.5.4 中输出中不再显示 Java home: 字段，而是改为 runtime: ... —— 它反映的是实际被调用的 JRE 路径，而非依赖 JAVA_HOME 推导的结果。
? 验证示例
假设你已将 JDK 的 bin/ 目录加入 PATH（例如 C:\jdk-17.0.2\bin），但未设置 JAVA_HOME：
立即学习“Java免费学习笔记（深入）”；
# 终端中可直接运行 $ java -version openjdk version "17.0.2" 2022-01-18 OpenJDK Runtime Environment (build 17.0.2+8-86) # Maven 3.6.3 可正常工作 $ mvn -version Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f) Maven home: /opt/apache-maven-3.6.3 Java version: 17.0.2, vendor: Private Build, runtime: /usr/lib/jvm/java-17-openjdk-amd64 Default locale: en_US, platform encoding: UTF-8 OS name: "linux", version: "5.15.0-91-generic", arch: "amd64", family: "unix"
注意输出中的 runtime: ... 行 —— 它正是 Maven 从当前 java 进程中动态获取的真实运行时路径。
⚠️ 注意事项与最佳实践
开发/CI 环境建议仍设置 JAVA_HOME：
尽管非必需，但显式配置 JAVA_HOME 可避免因 PATH 混乱（如多个 JDK 共存、java 指向 JRE 而非 JDK）导致的意外行为。尤其在 CI/CD 流水线中，明确指定 JDK 版本是构建可重现性的关键。JAVA_HOME 必须指向 JDK（非 JRE）根目录：
Maven 编译阶段需 javac 等工具，若 JAVA_HOME 指向仅含 JRE 的路径（如 /usr/lib/jvm/java-17-openjdk-amd64/jre），会导致 Failed to compile 错误。跨平台一致性：
Windows 用户常误将 JAVA_HOME 设为 ...\jre（旧习惯），应统一设为 JDK 根目录（如 C:\Program Files\Java\jdk-17.0.2）；Linux/macOS 同理（如 /usr/lib/jvm/java-17-openjdk-amd64）。-
验证方式（推荐组合检查）：
echo $JAVA_HOME # 查看是否设置 which java # 确认 PATH 中的 java 位置 mvn -v | grep "runtime\|Java version" # 观察实际生效的运行时
✅ 总结
Maven ≥3.5.4 的 JAVA_HOME 非强制性，是工程演进带来的便利性增强，而非功能弱化。它的本质是将 Java 发现逻辑从静态环境变量解耦为动态运行时探测，提升了开箱即用体验。但在专业开发、团队协作与持续集成场景下，主动配置 JAVA_HOME 仍是保障构建健壮性、可维护性与环境一致性的黄金实践。请根据项目成熟度权衡：快速原型可省略；生产级项目务必保留。
