Mac M1 Ventura环境下Java17与Maven3.9.3项目依赖解析错误排查

环境信息 #

• 设备：M1 MacBook Pro，系统Ventura
• Java：已安装Java 17 LTS，java --version显示17，但mvn --version显示Java 20.0.1
• Maven：通过brew安装3.9.3，已配置~/.zshrc并执行source生效
• 问题：创建Maven Web应用时，无法解析org.apache.maven.plugins:maven-dependency-plugin:3.9.3，提示该插件在中央仓库未找到且已缓存失败状态，执行mvn clean install无法解决

问题原因分析 #

1. Java版本不一致的原因 #

• Maven启动时优先读取JAVA_HOME环境变量指定的JDK，而非系统默认的java命令版本。如果你的JAVA_HOME未指向Java 17，而是指向了brew安装的Java 20（可能之前安装过未卸载），就会导致mvn --version显示的版本与java --version不一致。
• brew安装的Maven可能自动关联了brew维护的Java版本，若该版本是20，也会出现版本不匹配。

2. maven-dependency-plugin:3.9.3解析失败的原因 #

• 本地仓库缓存污染：之前拉取插件失败的状态被缓存到本地Maven仓库，Maven会直接读取缓存的失败标记，不再尝试重新拉取。
• 镜像仓库同步问题：如果配置了自定义Maven镜像（如国内镜像），该镜像可能未同步最新版本的插件，或者镜像地址失效，导致无法获取插件。
• Java版本兼容性：Maven 3.9.3搭配Java 20可能存在兼容性问题，导致插件解析或加载失败。
• NetBeans集成冲突：NetBeans可能未使用你本地配置的Maven和Java环境，而是用了内嵌的JDK或其他版本，导致插件解析异常。

解决步骤 #

统一Java版本 #

1. 检查当前JAVA_HOME配置：

   echo $JAVA_HOME
   

   确认输出是否为Java 17的安装路径（例如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）。
2. 若JAVA_HOME不正确，编辑~/.zshrc添加或修改配置：

   export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
   export PATH=$JAVA_HOME/bin:$PATH
   

   执行source ~/.zshrc生效后，再次执行mvn --version确认Java版本变为17。
3. 若存在多余的Java版本，可通过brew卸载：

   brew uninstall --cask java20
   

修复插件解析问题 #

1. 清理本地缓存：删除本地仓库中该插件的缓存目录：

   rm -rf ~/.m2/repository/org/apache/maven/plugins/maven-dependency-plugin/3.9.3
   

   之后重新执行mvn clean install，让Maven重新拉取插件。
2. 检查Maven镜像配置：
   打开~/.m2/settings.xml（若无则新建），确保镜像配置有效。若使用阿里云镜像，配置如下：

   <settings>
     <mirrors>
       <mirror>
         <id>aliyunmaven</id>
         <mirrorOf>central</mirrorOf>
         <url>https://maven.aliyun.com/repository/public</url>
       </mirror>
     </mirrors>
   </settings>
   

   若镜像失效，可暂时注释所有镜像配置，直接使用中央仓库尝试拉取。
3. 检查NetBeans配置：
   打开NetBeans，进入偏好设置 > Java > Maven，确认Maven主目录指向brew安装的Maven路径（例如/opt/homebrew/Cellar/maven/3.9.3/libexec）；再进入Java > 平台，确认默认平台为Java 17。

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