Maven 多模块项目执行 mvn install 时，即使源码未变更，也会因增量编译机制缺陷导致除首模块外的其余模块被强制重编译；根本原因是 maven-compiler-plugin 的已知 Bug（MCOMPILER-209），关闭增量编译即可恢复正常行为。
maven 多模块项目执行 `mvn install` 时，即使源码未变更，也会因增量编译机制缺陷导致除首模块外的其余模块被强制重编译；根本原因是 `maven-compiler-plugin` 的已知 bug（mcompiler-209），关闭增量编译即可恢复正常行为。
在多模块 Maven 项目（尤其是 NetBeans Platform 应用）中，mvn compile 能正确识别“无变更”，但 mvn install 却频繁触发不必要的全量重编译——典型表现为：第二次 install 时，仅第一个模块显示 “Nothing to compile”，其余模块均输出 Changes detected - recompiling the module!，并重新编译全部 .java 文件。
根本原因在于 maven-compiler-plugin 的增量编译逻辑存在长期未修复的缺陷（JIRA MCOMPILER-209）。该 Bug 导致插件在 install 阶段错误地将上游模块新生成的 *.jar（如 target/org-jjazz-utilities-1.0-SNAPSHOT.jar）识别为“依赖变更”，从而误判当前模块源码需重新编译——尽管 .java 和 .class 文件时间戳均未变化。
解决方案：显式禁用增量编译
在父 POM 的 <build><plugins> 中配置 maven-compiler-plugin，将 useIncrementalCompilation 设为 false：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.10.0</version>
<configuration>
<source>11</source>
<target>11</target>
<useIncrementalCompilation>false</useIncrementalCompilation>
</configuration>
</plugin>
</plugins>
</build>✅ 启用后，mvn install 将严格依据源文件与 class 文件的时间戳判断是否需要编译，行为与 mvn compile 一致，大幅提升重复构建效率。
⚠️ 注意：此设置不影响编译正确性，仅关闭有缺陷的增量检测逻辑；若使用较新版本（如 3.12.0+），建议仍优先验证该问题是否已修复，但截至 Maven 3.9.x 和 compiler-plugin 3.13.0，该 Bug 在部分场景下仍存在。
补充建议
- 确保所有子模块 pom.xml 不覆盖父 POM 的编译器配置；
- 若项目启用 maven-surefire-plugin 或 maven-failsafe-plugin，无需额外调整，其执行不受此配置影响；
- 开发阶段可结合 -T 1C（并行构建）进一步优化整体 install 速度，但核心仍需先修复增量编译误触发问题。
通过这一配置，即可彻底规避长达十年未解的“伪变更”重编译陷阱，让多模块 Maven 构建真正回归可预测、高效率的开发体验。
