本文详解如何在 maven 多模块项目中正确配置 jacoco 插件，解决 `report-aggregate` 仅生成跨模块但缺失本模块覆盖率、`jacoco.exec` 文件缺失、以及 `argline` 被覆盖等典型问题。
在 Maven 多模块项目中（如示例中的 DEF 父工程包含 module1、module2、module3），若仅在父 POM 中配置 JaCoCo 的 report-aggregate，却未同步启用各子模块的覆盖率数据采集，将导致聚合报告「有模块无数据」——例如 module1 的报告中只显示 module2 和 module3 的覆盖率，自身代码完全未被统计。根本原因在于：report-aggregate 仅负责合并 .exec 文件，但不会自动为子模块注入运行时探针；若子模块未执行 prepare-agent，则不会生成 target/jacoco.exec，自然无法参与聚合。
✅ 正确配置原则：父子协同 + argLine 安全继承
1. 父 POM：声明插件并启用聚合（不执行 prepare-agent）
<!-- DEF/pom.xml -->
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.11</version> <!-- 建议升级至 0.8.11+（0.8.8 存在已知聚合 Bug） -->
<executions>
<!-- 父模块不执行 prepare-agent，避免重复代理 -->
<execution>
<id>report-aggregate</id>
<phase>verify</phase>
<goals>
<goal>report-aggregate</goal>
</goals>
<configuration>
<outputDirectory>${project.build.directory}/reports/jacoco-aggregate</outputDirectory>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</pluginManagement>
</build>⚠️ 注意：<pluginManagement> 仅声明配置，不激活插件；实际启用需在子模块中显式引用。
2. 所有子模块（module1/module2/module3）：启用 prepare-agent 并安全继承 argLine
每个子模块的 pom.xml 必须显式启用 prepare-agent，且 必须使用 ${argLine} 占位符继承父级或已有 JVM 参数，否则自定义 argLine（如 -XX:PermSize=...）会覆盖 JaCoCo 的 -javaagent 探针，导致 jacoco.exec 无法生成：
<!-- module1/pom.xml -->
<build>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<!-- 无需声明 version，由 pluginManagement 统一管理 -->
<executions>
<execution>
<id>default-prepare-agent</id>
<goals>
<goal>prepare-agent</goal>
</goals>
<!-- 关键：确保 argLine 可扩展 -->
<configuration>
<argLine>${argLine} -XX:MaxMetaspaceSize=512m</argLine>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>3. 验证与执行流程
- 运行命令：mvn clean verify（verify 阶段触发 report-aggregate）
- 检查输出：
- 每个子模块 target/ 下应存在 jacoco.exec
- 父模块 target/reports/jacoco-aggregate/ 下生成完整 HTML 报告，包含所有模块源码树及合并覆盖率数据
? 常见陷阱与解决方案
- ❌ 错误：仅在父 POM 配置 prepare-agent → 子模块无 jacoco.exec，聚合为空
✅ 修复：子模块必须各自声明 prepare-agent 执行（可借助 <pluginManagement> 统一版本，但 <plugins> 需显式引入） - ❌ 错误：子模块硬编码 argLine（如 <argLine>-XX:PermSize=256m</argLine>）→ 覆盖 JaCoCo 探针
✅ 修复：始终用 ${argLine} 前缀拼接：<argLine>${argLine} -XX:... - ❌ 错误：使用过旧版本（如 0.8.8）→ report-aggregate 在某些 JDK 版本下跳过本模块
✅ 修复：升级至 JaCoCo 0.8.11 或更高稳定版
? 最佳实践总结
- 职责分离：父 POM 定义聚合逻辑，子模块负责数据采集；
- argLine 是关键：任何对 argLine 的修改都必须保留 ${argLine} 占位符；
- 验证先行：执行 mvn test 后检查各 target/jacoco.exec 是否存在（非空文件）；
- 统一版本：通过 <pluginManagement> 锁定 JaCoCo 版本，避免多模块版本不一致。
遵循以上配置，即可在多模块项目中获得准确、完整、可追溯的 Java 代码覆盖率报告。
