Maven 本身不支持在单次构建中为不同插件动态切换 JDK 版本；但可通过分离构建阶段、结合工具链（Toolchains）与 Shell/CI 脚本调度，实现插件级 JDK 隔离——核心方案是分步执行：主构建用 JDK 17，老旧插件（如不兼容 JDK 10+ 的 site 插件）单独用 JDK 8/9 执行。
maven 本身不支持在单次构建中为不同插件动态切换 jdk 版本；但可通过分离构建阶段、结合工具链（toolchains）与 shell/ci 脚本调度，实现插件级 jdk 隔离——核心方案是分步执行：主构建用 jdk 17，老旧插件（如不兼容 jdk 10+ 的 site 插件）单独用 jdk 8/9 执行。
在多模块或混合技术栈项目中，常遇到“新语言特性 + 旧插件”的兼容性困境：项目源码基于 Java 17 编写，maven-compiler-plugin 和 maven-surefire-plugin 均需 JDK 17 运行；但某个绑定在 site 生命周期的第三方插件（例如某定制化文档生成器 P1）因硬依赖已移除的 JDK 9 以下内部 API（如 com.sun.xml.internal.* 或反射访问 sun.misc.Unsafe），在 JDK 17 下直接抛出 NoSuchMethodError 或 InaccessibleObjectException。
此时，不能通过 <configuration> 或 <properties> 在 pom.xml 中为单个插件声明 JDK 版本——Maven 插件执行时共享同一 JVM 实例，其运行时 JDK 由启动 Maven 的 JAVA_HOME 决定，且 maven-toolchains-plugin 仅控制编译、测试等标准生命周期阶段的 JDK 选择，对插件自身的类加载和运行时环境无影响。
✅ 正确解法是：将插件执行从主构建流程中解耦，采用多阶段、多 JDK 的分步调用策略。具体如下：
✅ 推荐方案：分步 Maven 执行（简单、可靠、无需修改插件）
# 步骤 1：使用 JDK 17 完成主体构建（编译、测试、打包） export JAVA_HOME=/path/to/jdk-17 mvn clean install -DskipTests # 步骤 2：切换至兼容 JDK（如 JDK 8），仅执行目标插件 export JAVA_HOME=/path/to/jdk-8 mvn P1:goal -f pom.xml
⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- 确保 P1:goal 不依赖 compile 或 test-compile 阶段产物以外的中间结果（如 target/classes 已存在即可）；若需 site 相关资源，可在步骤 1 后保留 target/ 目录。
- 在 CI/CD（如 GitHub Actions、Jenkins）中，可定义两个 job：一个用 java-17 环境运行 mvn install，另一个用 java-8 环境运行 mvn P1:generate-site，并通过 workspace 共享 target/。
? 进阶方案：结合 maven-toolchains-plugin（仅适用于部分场景）
虽然 toolchains 不能改变插件运行时 JDK，但它可辅助条件化跳过不兼容插件，避免误触发：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-toolchains-plugin</artifactId>
<version>3.1.0</version>
<executions>
<execution>
<goals>
<goal>toolchain</goal>
</goals>
</execution>
</executions>
<configuration>
<toolchains>
<jdk>
<version>[1.8,9)</version>
</jdk>
</toolchains>
</configuration>
</plugin>再配合 profile 控制插件激活：
<profile>
<id>legacy-site</id>
<activation>
<property>
<name>toolchain.jdk.version</name>
<value>1.8</value>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>com.example</groupId>
<artifactId>P1</artifactId>
<version>1.0.0</version>
<executions>
<execution>
<phase>site</phase>
<goals><goal>generate</goal></goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>此时需手动确保 mvn -t toolchains.xml site 在 JDK 8 下执行，否则 profile 不激活。
✅ 总结
- Maven 不支持插件粒度的 JDK 切换，这是设计限制，非配置疏漏；
- 分步执行是最务实、零侵入的解决方案，兼顾安全性与可维护性；
- 避免尝试通过 fork=true、jvmArgs 或自定义 classloader 强行隔离——这极易引发类加载冲突或 SecurityManager 报错；
- 长期建议推动插件升级或寻找替代方案（如用 maven-javadoc-plugin 替代老旧文档插件），但当前目标“不修改插件”下，分步调用即为最佳实践。
