多模块Maven项目JaCoCo配置：仅统计模块自有测试覆盖率

完全可以实现你想要的效果——在覆盖率收集阶段就限制每个模块仅记录自身类的覆盖率数据，而不是等到生成报告时再过滤。下面是针对Maven项目的具体配置方案：

核心思路：利用JaCoCo Agent的includes参数精准控制收集范围 #

JaCoCo的Agent在插桩和收集覆盖率数据时，支持通过includes参数指定只对特定包路径下的类进行数据记录。我们可以给每个模块配置专属的包路径规则，这样Agent在运行该模块测试时，只会处理当前模块的类，其他依赖模块的类即使被调用，也不会被写入该模块的jacoco.exec文件。

具体配置步骤 #

1. 父POM中定义JaCoCo插件模板（可选但推荐） #

为了避免每个模块重复编写插件配置，建议在父POM中定义基础的JaCoCo插件配置，子模块通过继承并覆盖包路径参数来实现个性化配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.jacoco</groupId>
      <artifactId>jacoco-maven-plugin</artifactId>
      <version>0.8.11</version> <!-- 使用最新稳定版本 -->
      <executions>
        <!-- 准备Agent，用于单元测试覆盖率收集 -->
        <execution>
          <id>prepare-agent</id>
          <goals>
            <goal>prepare-agent</goal>
          </goals>
          <configuration>
            <!-- 通过变量传递子模块的包路径规则 -->
            <includes>
              <include>${jacoco.module.includes}</include>
            </includes>
          </configuration>
        </execution>
        <!-- 生成模块本地覆盖率报告 -->
        <execution>
          <id>report</id>
          <goals>
            <goal>report</goal>
          </goals>
        </execution>
        <!-- 如果有集成测试，添加failsafe的Agent配置 -->
        <execution>
          <id>prepare-agent-integration</id>
          <goals>
            <goal>prepare-agent-integration</goal>
          </goals>
          <configuration>
            <includes>
              <include>${jacoco.module.includes}</include>
            </includes>
          </configuration>
        </execution>
        <execution>
          <id>report-integration</id>
          <goals>
            <goal>report-integration</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

2. 子模块中配置专属包路径 #

在每个子模块的pom.xml中，定义jacoco.module.includes属性，指定当前模块的包路径（比如模块A的包是com.example.modulea）：

<properties>
  <!-- 仅收集当前模块包下所有类的覆盖率 -->
  <jacoco.module.includes>com.example.modulea.**</jacoco.module.includes>
</properties>

3. 验证配置效果 #

运行单个模块的测试（比如mvn clean test jacoco:report），然后查看该模块target/jacoco目录下的jacoco.exec文件，或者直接看生成的HTML报告——你会发现报告里只包含当前模块的类，依赖模块的类不会出现在覆盖率数据中。

如果想更精准验证，可以用JaCoCo CLI工具分析exec文件：

# 假设你已经下载了jacococli.jar
java -jar jacococli.jar report target/jacoco/jacoco.exec --classfiles target/classes --html target/jacoco/verify-report

打开生成的verify-report，确认所有类都是当前模块的。

注意事项 #

• 确保包路径唯一：每个模块的包路径要清晰区分，避免出现跨模块包路径重叠的情况，否则可能导致误收集。
• 集成测试同步配置：如果项目使用maven-failsafe-plugin运行集成测试，一定要同步配置prepare-agent-integration的includes参数，确保集成测试的覆盖率也只记录当前模块的类。
• 版本兼容性：尽量使用最新稳定版的JaCoCo插件，避免旧版本的参数兼容性问题。

这样配置后，每个模块的jacoco.exec文件只会记录自身类的覆盖率数据，完全满足你"各模块自行负责自身测试与覆盖率统计"的严格规则。

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