为何Maven compile生命周期阶段不仅编译修改的Java文件？

我有一个使用JDK 1.8和Maven 3.9构建工具的Java项目。以下是项目的pom.xml配置：

<?xml version="1.0" encoding="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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.mycompany</groupId>
    <artifactId>testprojectcodestyle</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <java.version>1.8</java.version>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.0.0</version>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <compilerVersion>${java.version}</compilerVersion>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

首次执行mvn compile阶段时，编译了5个文件，符合预期。但仅修改单个文件后再次执行该命令，却仍编译全部5个文件。请问这是什么原因？能否配置Maven仅编译修改的文件？

Maven默认依赖源文件与编译后class文件的时间戳差异实现增量编译，出现全量编译的核心原因如下：

1. maven-compiler-plugin版本过旧：你使用的3.1版本是2012年的旧版本，与高版本Maven（如3.9）兼容性不足，增量编译逻辑存在缺陷，无法正确识别单文件修改状态。
2. 冗余配置冲突：pom中同时通过全局属性和插件配置重复定义source/target参数，旧版本插件处理这类配置时可能出现异常，导致增量判断失效。

通过调整配置可以实现Maven仅编译修改的文件，具体步骤如下：

1. 升级maven-compiler-plugin版本 #

将插件版本升级到兼容JDK 1.8的稳定版本3.11.0，新版本修复了旧版本的增量编译缺陷，默认支持增量编译：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <!-- 显式开启增量编译，新版本默认已开启，可按需添加 -->
        <incremental>true</incremental>
    </configuration>
</plugin>

同时移除过时的compilerVersion参数，source和target已足够指定JDK版本。

2. 简化编译配置 #

全局属性中已定义maven.compiler.source和maven.compiler.target，插件会自动读取这些属性，可简化插件配置避免冲突：

<properties>
    <java.version>1.8</java.version>
    <maven.compiler.source>${java.version}</maven.compiler.source>
    <maven.compiler.target>${java.version}</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<!-- 简化后的插件配置 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <incremental>true</incremental>
    </configuration>
</plugin>

3. 验证增量编译 #

修改单个Java文件后执行mvn compile，若控制台输出Compiling 1 source file，则说明增量编译生效。若仍全量编译，可排查：

• 是否有其他插件（如maven-clean-plugin）绑定到compile阶段前的生命周期，导致class目录被清理；
• 系统时间是否异常，是否导致Maven误判文件时间戳。

内容的提问来源于stack exchange，提问作者Alexei