构建与依赖 / 系统课时
配置 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。
mvn -version预期结果应包含类似信息,具体 Maven 小版本与安装路径可能不同:
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。
<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。中文字符串可以顺便验证源码读取编码是否正确。
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 是否覆盖了配置。
mvn clean compile
java -cp target/classes example.App
javap -verbose target/classes/example/App.class预期结果中应看到以下关键内容;Maven 日志和 javap 的其他行可以不同:
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> 内:
<source>8</source>
<target>8</target>
<encoding>${project.build.sourceEncoding}</encoding>如果团队目标明确为 Java 17,最稳妥的验收条件就是三项同时成立:mvn -version 显示 Maven 使用 JDK 17 或更高、编译成功且中文源码无乱码、javap 显示 major version 61。