本文详解 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免费学习笔记（深入）”；
