构建与依赖 / 系统课时

配置 Maven Compiler Plugin

配置 Maven Compiler Plugin

编译配置最常见的问题不是“能不能编过”,而是开发机、CI 和运行环境得到的字节码规则不一致。本节用 Maven Compiler Plugin 3.16.0 固定 Java 17、UTF-8 编码,并验证生成的 class 文件确实是 Java 17 目标版本。

学习目标

  • 会使用 release 配置目标 Java 版本,并理解它与 source、target 的区别。
  • 会固定源码编码,避免不同操作系统默认编码造成编译差异。
  • 会用 mvn、java 和 javap 验证编译配置是否真正生效。

先确认 Maven 正在使用哪个 JDK

本例目标是 Java 17,因此运行 Maven 的 JDK 至少应为 17。先在项目目录执行版本检查,重点看 Java version,而不是只看系统里是否安装过某个 JDK。

bash
mvn -version

预期结果应包含类似信息,具体 Maven 小版本与安装路径可能不同:

text
Apache Maven <VERSION>
Java version: 17

如果这里显示 Java 11,而你的终端中 java -version 又显示 Java 17,通常说明 Maven 实际使用的 JAVA_HOME 与当前 java 命令来源不一致,应先统一环境再配置插件。

用 release 和 UTF-8 固定编译规则

对现代 JDK,优先使用 release。它不仅限制 Java 语法和 class 文件目标版本,还限制可用的 Java SE API,能避免“用较新 JDK 编译时误调用目标版本不存在的 API”。下面的完整 POM 使用 Compiler Plugin 3.16.0,并把源码编码显式设为 UTF-8。

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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>example</groupId>
  <artifactId>compiler-demo</artifactId>
  <version>1.0.0</version>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.16.0</version>
        <configuration>
          <release>17</release>
          <encoding>${project.build.sourceEncoding}</encoding>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

encoding 对应编译器的源码编码参数,而 Maven Compiler Plugin 默认也会读取 ${project.build.sourceEncoding}。在团队项目中保留这个属性还有额外好处:其他读取项目源码编码的 Maven 插件也能复用同一值。

编译一个最小项目并检查字节码

新建 src/main/java/example/App.java,保存为 UTF-8。中文字符串可以顺便验证源码读取编码是否正确。

java
package example;

public class App {
    public static void main(String[] args) {
        // 中文字面量用于确认源码按 UTF-8 被正确读取。
        System.out.println("编译配置正常");
    }
}

依次编译、运行,再查看 class 文件的 major version。Java 17 对应 major version 61;如果这里不是 61,就要回头检查生效 POM、Profile 或父 POM 是否覆盖了配置。

bash
mvn clean compile
java -cp target/classes example.App
javap -verbose target/classes/example/App.class

预期结果中应看到以下关键内容;Maven 日志和 javap 的其他行可以不同:

text
BUILD SUCCESS
编译配置正常
major version: 61

常用目标版本可以用 class major version 反查:Java 8 是 52,Java 11 是 55,Java 17 是 61。这个检查比只看 POM 更可靠,因为它直接验证最终产物。

release、source、target 该怎么选

source 只控制接受哪一版 Java 语法,target 控制生成哪一版 class 文件;单独使用这两项并不会阻止代码引用较新 JDK 才有的 API。release 在 JDK 9 起由 javac 提供,因此新项目通常应选 release,不要在同一次编译配置里同时再填 source 和 target。

维护旧项目时,可能仍会看到下面这种配置。它能生成面向 Java 8 的字节码,但如果 Maven 实际运行在较新的 JDK 上,还需要额外防止误用 Java 9+ API,因此不如 release 完整。

片段示例,需放在 maven-compiler-plugin 的 <configuration> 内:

xml
<source>8</source>
<target>8</target>
<encoding>${project.build.sourceEncoding}</encoding>

如果团队目标明确为 Java 17,最稳妥的验收条件就是三项同时成立:mvn -version 显示 Maven 使用 JDK 17 或更高、编译成功且中文源码无乱码、javap 显示 major version 61。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Maven Compiler Plugin

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通