Mac上Maven运行报错：JAVA_HOME环境变量配置异常求助

排查步骤与解决方案 #

• 验证JAVA_HOME路径有效性
  直接执行JAVA_HOME路径下的Java命令，确认该JDK确实可用：

  /Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Home/bin/java -version
  

  若能正常输出Java 14.0.1版本信息，说明路径无问题；若报错，检查JDK是否真的安装在该目录，或目录权限是否正常。

• 确保Zsh正确加载环境变量
  Zsh的配置文件加载逻辑和Bash不同，建议将环境变量配置到~/.zshrc中：

  1. 打开配置文件：

     open ~/.zshrc
     

  2. 添加或确认以下配置：

     export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Home"
     export M2_HOME="/Users/username/Downloads/apache-maven-3.9.5"
     export PATH="$M2_HOME/bin:$JAVA_HOME/bin:$PATH"
     

  3. 保存后重新加载配置：

     source ~/.zshrc
     

• 检查环境变量是否生效
  执行以下命令确认变量已正确导出：

  echo $JAVA_HOME
  echo $PATH | grep maven
  

  需确保输出的JAVA_HOME路径正确，且PATH中包含$M2_HOME/bin。

• 清除终端缓存重试
  关闭当前终端窗口，重新打开一个新终端后再执行mvn -v——旧终端的环境变量缓存可能导致配置不生效。

若以上步骤完成后仍报错，可重新下载apache-maven-3.9.5安装包，解压替换现有目录后再重复上述操作。

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