macOS 11.6.7下Maven无法识别JAVA_HOME的问题求助

我使用macOS 11.6.7系统，已在~/.zshenv中配置：export JAVA_HOME=$(/usr/libexec/java_home)。执行echo $JAVA_HOME能正确输出/Library/Java/JavaVirtualMachines/jdk-18.0.2.jdk/Contents/Home，但运行mvn --version时提示：

The JAVA_HOME environment variable is not defined correctly,
this environment variable is needed to run this program.

我已尝试source ~/.zshenv和重启Shell，JAVA_HOME仍能正常读取，请问遗漏了什么？是否需要针对Maven检查或配置其他文件？

解决方法 #

• 检查Maven的执行环境
  如果是通过IDE或其他GUI程序调用Maven，而非当前终端会话，这类环境可能不会加载用户的~/.zshenv配置。确保在同一个终端里运行mvn --version，或者在IDE的Maven设置中手动指定JAVA_HOME的完整路径。

• 验证JAVA_HOME路径有效性
  执行以下命令确认JDK路径下的核心文件存在：

  ls $JAVA_HOME/bin/java
  

  如果能输出文件路径，说明路径没问题；如果报错，大概率是JDK安装损坏，重新安装对应版本的JDK即可。

• 调整JAVA_HOME的配置位置
  ~/.zshenv是zsh的全局环境配置，但部分终端启动模式（比如登录模式）可能不会优先加载它。把export JAVA_HOME=$(/usr/libexec/java_home)移到~/.zshrc里，然后执行source ~/.zshrc，再重新运行mvn --version测试。

• 检查Maven的专属配置文件
  查看Maven安装目录下的conf/mavenrc，或者用户目录下的~/.mavenrc，如果里面有覆盖JAVA_HOME的配置（比如export JAVA_HOME=空值），直接删除或修改成正确的路径。

• 临时指定JAVA_HOME测试
  在终端里直接用以下命令运行Maven，验证是否是环境变量加载问题：

  JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-18.0.2.jdk/Contents/Home mvn --version
  

  如果这个命令能正常输出版本信息，说明问题出在环境变量的加载时机或作用域，按照前面的方法调整配置文件即可。

内容的提问来源于stack exchange，提问作者Heinzen