Maven多模块项目Jacoco集成测试覆盖率报告空白问题求助

核心问题分析 #

integration-tests模块本身无主源码，Jacoco默认仅扫描当前模块的src/main/java与编译类文件。即便指定了源码路径，若未正确关联plugin模块的编译后类文件，仍会出现"分析0个类"的情况。此外，集成测试运行时生成的Jacoco数据文件需正确指向被测类的字节码，否则无法统计覆盖率。

具体配置方案 #

1. 配置integration-tests模块的Jacoco插件 #

在integration-tests模块的pom.xml中，显式指定classDirectory（plugin模块编译类文件路径）、sourceDirectory（plugin模块源码路径），同时确保测试运行时Jacoco agent正确记录覆盖率数据：

<build>
    <plugins>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.11</version> <!-- 使用最新稳定版本 -->
            <executions>
                <!-- 为集成测试准备Jacoco agent -->
                <execution>
                    <id>jacoco-integration-prepare-agent</id>
                    <goals>
                        <goal>prepare-agent-integration</goal>
                    </goals>
                    <configuration>
                        <propertyName>jacoco.integration.agent.argLine</propertyName>
                    </configuration>
                </execution>
                <!-- 生成集成测试覆盖率报告 -->
                <execution>
                    <id>jacoco-integration-report</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>report-integration</goal>
                    </goals>
                    <configuration>
                        <!-- 指定被测代码的编译类文件路径 -->
                        <classDirectory>${project.basedir}/../plugin/target/classes</classDirectory>
                        <!-- 指定被测代码的源码路径 -->
                        <sourceDirectory>${project.basedir}/../plugin/src/main/java</sourceDirectory>
                        <!-- 可选：指定集成测试源码路径 -->
                        <testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <!-- 确保集成测试使用Jacoco agent参数 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <version>3.2.5</version>
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <argLine>${jacoco.integration.agent.argLine}</argLine>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 合并单元测试与集成测试覆盖率报告（可选） #

若需生成包含两种测试的合并报告，可在父pom中配置Jacoco的merge目标：

<build>
    <plugins>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.11</version>
            <executions>
                <!-- 合并单元测试与集成测试的覆盖率数据 -->
                <execution>
                    <id>jacoco-merge</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>merge</goal>
                    </goals>
                    <configuration>
                        <fileSets>
                            <fileSet>
                                <directory>${project.basedir}/plugin/target/jacoco</directory>
                                <includes>
                                    <include>jacoco.exec</include>
                                </includes>
                            </fileSet>
                            <fileSet>
                                <directory>${project.basedir}/integration-tests/target/jacoco</directory>
                                <includes>
                                    <include>jacoco-it.exec</include>
                                </includes>
                            </fileSet>
                        </fileSets>
                        <destFile>${project.build.directory}/jacoco-merged.exec</destFile>
                    </configuration>
                </execution>
                <!-- 生成合并后的覆盖率报告 -->
                <execution>
                    <id>jacoco-merged-report</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>report</goal>
                    </goals>
                    <configuration>
                        <dataFile>${project.build.directory}/jacoco-merged.exec</dataFile>
                        <classDirectory>${project.basedir}/plugin/target/classes</classDirectory>
                        <sourceDirectory>${project.basedir}/plugin/src/main/java</sourceDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3. 关键检查点 #

• 确认模块编译顺序：Maven默认按pom中声明顺序执行模块构建，确保plugin模块在integration-tests之前完成编译。
• 检查Jacoco数据文件：确认integration-tests模块的target/jacoco/jacoco-it.exec文件存在且非空，若为空则说明集成测试未正确加载Jacoco agent。
• 验证路径正确性：使用${project.basedir}时，确保相对路径指向正确（Maven会自动处理跨系统路径分隔符问题）。

验证步骤 #

1. 执行命令：mvn clean verify
2. 查看integration-tests模块下的target/site/jacoco-it/index.html，确认是否显示plugin模块的类覆盖率数据。
3. 若配置了合并报告，查看父模块target/site/jacoco/index.html，确认包含单元测试与集成测试的合并覆盖率。

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