本文详解 macOS（M1/M2）环境下 Java 17 与 Maven 混用时因插件版本不兼容导致的 maven-dependency-plugin:3.9.3 not found 错误，提供可直接使用的 POM 配置、版本适配原则与环境验证步骤。
本文详解 macos（m1/m2）环境下 java 17 与 maven 混用时因插件版本不兼容导致的 `maven-dependency-plugin:3.9.3 not found` 错误，提供可直接使用的 pom 配置、版本适配原则与环境验证步骤。
在 macOS Ventura 系统（尤其是 Apple Silicon M1/M2 芯片）上使用 NetBeans 创建 Jakarta EE Web 项目时，常遇到看似诡异的 Maven 构建失败：即使 mvn --version 显示正常，运行项目仍报错：
Plugin org.apache.maven.plugins:maven-dependency-plugin:3.9.3 or one of its dependencies could not be resolved: The following artifacts could not be resolved: ... was not found in https://repo.maven.apache.org/maven2
该错误并非网络或仓库问题，而是典型的 Maven 插件版本与 Java 版本/构建环境不兼容所致。
? 根本原因分析
- Maven 3.9.3 自身支持 JDK 17+，但其插件生态存在版本断层：
maven-dependency-plugin3.9.3 并未正式发布（截至 2024 年中，最新稳定版为3.6.1；3.9.3是无效版本号，Maven 中央仓库中根本不存在）。 - 同理，
maven-war-plugin:3.9.3和maven-compiler-plugin:3.9.3均为不存在的版本——官方最新稳定版分别为3.3.2（WAR 插件）和3.11.0（编译插件），而3.6.0是广泛验证兼容 Java 17 的成熟选择。 - 当 POM 中声明了不存在的插件版本（如
3.9.3），Maven 会尝试从中央仓库下载，失败后缓存“不可用”状态，后续构建不再重试，导致持续报错。
✅ 正确解决方案：使用经验证的稳定插件版本
以下为适配 Java 17 + Jakarta EE 10 + Maven 3.9.x（或更高） 的最小可行 pom.xml 配置（已去除无效版本、统一源码/目标版本、增强可维护性）：
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelversion>4.0.0</modelversion><groupid>com.mycompany</groupid><artifactid>w1</artifactid><version>1.0-SNAPSHOT</version><packaging>war</packaging><name>w1-1.0-SNAPSHOT</name><properties><!-- 统一指定 Java 17 --><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><project.build.sourceencoding>UTF-8</project.build.sourceencoding><failonmissingwebxml>false</failonmissingwebxml><jakartaee>10.0.0</jakartaee><endorsed.dir>${project.build.directory}/endorsed</endorsed.dir></properties><dependencies><dependency><groupid>jakarta.platform</groupid><artifactid>jakarta.jakartaee-api</artifactid><version>${jakartaee}</version><scope>provided</scope></dependency></dependencies><build><plugins><!-- ✅ 推荐：maven-compiler-plugin 3.6.0 —— 兼容 Java 17，成熟稳定 --><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.6.0</version><configuration><source>${maven.compiler.source}</source><target>${maven.compiler.target}</target><compilerarguments><endorseddirs>${endorsed.dir}</endorseddirs></compilerarguments></configuration></plugin><!-- ✅ 推荐：maven-war-plugin 3.3.2 —— Jakarta EE 9+/10 官方推荐 --><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-war-plugin</artifactid><version>3.3.2</version><configuration><failonmissingwebxml>false</failonmissingwebxml></configuration></plugin><!-- ✅ 推荐：maven-dependency-plugin 3.6.1（或 3.1.2）—— 支持 copy endorsed JARs --><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-dependency-plugin</artifactid><version>3.6.1</version><executions><execution><phase>validate</phase><goals><goal>copy</goal></goals><configuration><outputdirectory>${endorsed.dir}</outputdirectory><silent>true</silent><artifactitems><artifactitem><groupid>jakarta.platform</groupid><artifactid>jakarta.jakartaee-api</artifactid><version>${jakartaee}</version><type>jar</type></artifactitem></artifactitems></configuration></execution></executions></plugin></plugins></build></project>
⚠️ 关键注意事项
-
勿盲目匹配 Maven 主版本号：
maven-xxx-plugin:3.9.3≠Maven 3.9.3。插件版本独立演进，需查阅 Maven Plugins 官方文档 或 Maven Central 确认真实可用版本。 -
清理本地仓库缓存：若曾多次失败，执行以下命令强制刷新依赖解析：
mvn clean dependency:purge-local-repository -DreResolve=false # 或彻底删除对应插件目录（谨慎操作）： rm -rf ~/.m2/repository/org/apache/maven/plugins/maven-dependency-plugin/
-
验证 Java 与 Maven 实际绑定：确保 NetBeans 使用的是你期望的 JDK（而非 Maven 自带的 JDK 20）。在 NetBeans → Preferences → Java → Maven → Java Platform 中显式指定
JDK 17。 -
.zshrcPATH 修正：你当前的PATH行末尾有截断（.../maven/3.9$），请修正为完整路径，并确保JAVA_HOME指向 JDK 17：export JAVA_HOME=$(/usr/libexec/java_home -v 17) export MAVEN_HOME=/opt/homebrew/Cellar/maven/3.9.3/libexec export PATH=$MAVEN_HOME/bin:$PATH
✅ 验证步骤（终端执行）
# 1. 确认 Java 版本（应为 17.x） java -version # 2. 确认 Maven 使用的 Java（应显示 17） mvn -version # 3. 清理并首次构建（观察是否成功下载插件） mvn clean compile # 4. 构建 WAR 包 mvn clean package
通过以上配置与验证，即可彻底解决 maven-dependency-plugin:3.9.3 not found 类错误，在 Java 17 环境下稳定运行 Jakarta EE 10 Web 应用。记住：版本兼容性 > 版本数字一致性——选择经过社区广泛验证的稳定组合，远胜追求“最新版”数字。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
