自 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 环境变量。这一变化显著提升了开箱即用体验，尤其在 CI/CD 环境、容器化部署或多 JDK 共存场景中更为灵活。
✅ 工作原理：自动探测优先级
Maven 启动时按以下顺序查找 Java 运行时：
- 优先检查 JAVA_HOME（若已设置且有效，则直接使用）；
- fallback 到 PATH 中的 java 命令：执行 which java（Linux/macOS）或 where java（Windows），解析其符号链接并向上追溯至 JDK 根目录（如 /usr/lib/jvm/openjdk-17 或 C:\Program Files\Java\jdk-17.0.1）；
- 若两者均不可用，则报错：The JAVA_HOME environment variable is not defined correctly...
该机制由 Maven 内置的 MavenLauncher 和底层 org.codehaus.plexus.util.cli.CommandLineUtils 共同实现，确保能准确识别 JDK（而非仅 JRE），并提取 jre/ 或 jmods/ 等关键路径。
? 验证示例
假设你已将 OpenJDK 17 的 bin/ 目录加入 PATH（但未设 JAVA_HOME）：
立即学习“Java免费学习笔记（深入）”；
$ echo $PATH | grep -o '/opt/java/jdk-17.0.1/bin' /opt/java/jdk-17.0.1/bin $ mvn -version Apache Maven 3.9.6 (bc021a3f0c8e0b0e3d4e0b0e3d4e0b0e3d4e0b0e; 2023-11-22T15:30:00+01:00) Maven home: /opt/apache-maven-3.9.6 Java version: 17.0.1, vendor: Oracle Corporation, runtime: /opt/java/jdk-17.0.1 Default locale: en_US, platform encoding: UTF-8 OS name: "linux", version: "6.5.0-1020-oem", arch: "amd64", family: "unix"
注意输出中 runtime: 字段明确指向完整 JDK 路径（非 JRE），证明 Maven 成功通过 java 命令反向解析出 JDK 安装根目录。
⚠️ 注意事项与最佳实践
不推荐完全弃用 JAVA_HOME：
尽管技术上可行，但在企业级构建、IDE 集成（如 IntelliJ）、多模块项目或跨平台 CI（GitHub Actions、GitLab Runner）中，显式声明 JAVA_HOME 可避免因 PATH 解析歧义导致的 JDK 版本误判（例如 PATH 中混有旧版 java）。-
JAVA_HOME 必须指向 JDK，而非 JRE：
Maven 编译需 javac，因此 JAVA_HOME 应包含 bin/javac。错误示例：# ❌ 错误：指向 JRE（无 javac） export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/jre # ✅ 正确：指向 JDK 根目录 export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
-
Docker 环境建议双保险：
FROM maven:3.9.6-openjdk-17-slim # Maven 自动识别 /usr/lib/jvm/java-17-openjdk-amd64 下的 JDK # 但仍显式声明以增强可读性与兼容性 ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
✅ 总结
| 场景 | 是否需要 JAVA_HOME | 说明 |
|---|---|---|
| Maven ≤ 3.5.3 | ✅ 强制要求 | 否则启动失败 |
| Maven ≥ 3.5.4（PATH 有 java） | ❌ 非强制，但强烈推荐 | 自动探测可靠，但显式配置更稳健 |
| 多 JDK 环境 / CI 流水线 | ✅ 推荐 | 消除不确定性，保障构建可重现 |
简言之：Maven 已“学会自己找 Java”，但作为工程师，我们仍应主动指明——这既是专业习惯，也是生产稳定性的基石。
