如何为不同 Maven 插件指定独立的 Java 版本运行环境

在Maven项目构建过程中，不同插件对Java版本的要求可能存在差异，比如部分老旧的代码生成插件仅支持Java 8，而新的测试框架插件需要Java 11及以上版本。如果全局统一使用同一个Java版本，很容易出现插件执行失败的情况，因此需要为不同Maven插件指定独立的Java版本运行环境。

方案一：使用Maven Toolchains配置

Maven Toolchains是官方提供的多Java版本管理方案，通过统一的toolchains文件定义所有可用的Java版本，再在插件中引用对应的toolchain即可，适合多个插件需要不同Java版本的场景。

1. 配置toolchains.xml文件

在用户目录的.m2目录下创建或修改toolchains.xml文件，定义不同版本的Java路径：

<toolchains xmlns="http://maven.apache.org/TOOLCHAINS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/TOOLCHAINS/1.1.0 http://maven.apache.org/xsd/toolchains-1.1.0.xsd">
  <!-- 定义Java 8环境 -->
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>8</version>
    </provides>
    <configuration>
      <jdkHome>/usr/lib/jvm/java-8-openjdk</jdkHome>
    </configuration>
  </toolchain>
  <!-- 定义Java 11环境 -->
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>11</version>
    </provides>
    <configuration>
      <jdkHome>/usr/lib/jvm/java-11-openjdk</jdkHome>
    </configuration>
  </toolchain>
</toolchains>

2. 在插件中引用toolchain

在项目的pom.xml中，为需要指定Java版本的插件添加toolchain配置，以maven-compiler-plugin和maven-surefire-plugin为例：

<build>
  <plugins>
    <!-- 编译插件使用Java 8 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
      </configuration>
      <dependencies>
        <dependency>
          <groupId>org.apache.maven.toolchain</groupId>
          <artifactId>maven-toolchain-api</artifactId>
          <version>1.0</version>
        </dependency>
      </dependencies>
    </plugin>
    <!-- 测试插件使用Java 11 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>3.2.5</version>
      <configuration>
        <toolchains>
          <jdk>
            <version>11</version>
          </jdk>
        </toolchains>
      </configuration>
    </plugin>
  </plugins>
</build>

方案二：直接在插件配置中指定Java可执行路径

如果只有个别插件需要指定独立的Java版本，也可以直接在插件的配置中指定javaHome或者jvm参数，不需要额外配置toolchains文件，操作更简便。

1. 为maven-compiler-plugin指定Java路径

编译插件可以通过executable参数指定Java编译器的路径：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
  <configuration>
    <source>1.8</source>
    <target>1.8</target>
    <!-- 指定Java 8的javac路径 -->
    <executable>/usr/lib/jvm/java-8-openjdk/bin/javac</executable>
  </configuration>
</plugin>

2. 为maven-surefire-plugin指定Java路径

测试插件可以通过jvm参数指定Java虚拟机的路径：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.2.5</version>
  <configuration>
    <!-- 指定Java 11的java可执行文件路径 -->
    <jvm>/usr/lib/jvm/java-11-openjdk/bin/java</jvm>
  </configuration>
</plugin>

两种方案对比

以下是两种方案的适用场景和特点对比：

注意事项

• 指定的Java路径必须真实存在，否则插件执行时会报找不到Java环境的错误
• 如果插件本身对Java版本有最低要求，指定的Java版本不能低于插件要求的最低版本
• Windows系统下的Java路径需要写成类似C:Program FilesJavajdk1.8.0_301binjavac.exe的格式
• 修改配置后建议执行mvn clean清理之前的构建缓存，避免配置不生效

MavenJava_versionplugin_configurationtoolchainsmaven_compiler_plugin修改时间：2026-07-21 18:36:34