Maven POM打包项目中Jacoco代码覆盖率文件生成失败求助

Hey there! Let's figure out why you're not seeing Jacoco's coverage files after running mvn install. Looking at your POM, two key issues stand out immediately:

1. 你的父POM完全没有配置Jacoco插件 #

Your current POM is a parent project (<packaging>pom</packaging>) with zero Jacoco plugin setup. Without this configuration, Maven has no instruction to run Jacoco's coverage collection during the build process.

2. 多模块项目的配置要点 #

Since this is a multi-module project, you need to set up Jacoco either in the parent POM (so all child modules inherit the configuration) or in specific child modules where you want coverage tracking.

解决方案：添加Jacoco插件配置 #

Add the following <build> section to your parent POM (right before the closing </project> tag). This setup will collect coverage data for both unit and integration tests, and generate corresponding reports:

<build>
    <pluginManagement>
        <plugins>
            <!-- Jacoco核心配置 -->
            <plugin>
                <groupId>org.jacoco</groupId>
                <artifactId>jacoco-maven-plugin</artifactId>
                <version>0.8.11</version> <!-- 使用最新稳定版本 -->
                <executions>
                    <!-- 为单元测试准备Jacoco代理 -->
                    <execution>
                        <id>jacoco-prepare-agent</id>
                        <goals>
                            <goal>prepare-agent</goal>
                        </goals>
                        <configuration>
                            <propertyName>jacoco.agent.argLine</propertyName>
                        </configuration>
                    </execution>
                    <!-- 为集成测试准备Jacoco代理 -->
                    <execution>
                        <id>jacoco-prepare-agent-integration</id>
                        <goals>
                            <goal>prepare-agent-integration</goal>
                        </goals>
                        <configuration>
                            <propertyName>jacoco.agent.it.argLine</propertyName>
                        </configuration>
                    </execution>
                    <!-- 生成单元测试覆盖率报告 -->
                    <execution>
                        <id>jacoco-report</id>
                        <goals>
                            <goal>report</goal>
                        </goals>
                    </execution>
                    <!-- 生成集成测试覆盖率报告 -->
                    <execution>
                        <id>jacoco-integration-report</id>
                        <goals>
                            <goal>report-integration</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <!-- Surefire插件（单元测试）关联Jacoco -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>${maven-surefire-plugin.version}</version>
                <configuration>
                    <argLine>${jacoco.agent.argLine}</argLine>
                    <skipTests>${ut.skip}</skipTests>
                </configuration>
            </plugin>
            <!-- Failsafe插件（集成测试）关联Jacoco -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-failsafe-plugin</artifactId>
                <version>${maven-failsafe-plugin.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>integration-test</goal>
                            <goal>verify</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <argLine>${jacoco.agent.it.argLine}</argLine>
                    <skipTests>${it.skip}</skipTests>
                </configuration>
            </plugin>
        </plugins>
    </pluginManagement>
    <!-- 启用插件，子模块会自动继承 -->
    <plugins>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
        </plugin>
    </plugins>
</build>

配置各部分作用解释 #

• prepare-agent / prepare-agent-integration: 配置JVM参数，让Jacoco在单元/集成测试执行时收集代码覆盖率数据，通过自定义属性传递给测试插件，避免参数冲突。
• report / report-integration: 在测试完成后生成HTML、XML、CSV格式的覆盖率报告，其中HTML报告最直观，方便查看。
• Surefire/Failsafe配置: 将Jacoco代理参数注入测试插件，确保测试运行时Jacoco能正常收集数据。

正确执行Maven命令 #

建议使用以下命令替代单纯的mvn install：

mvn clean verify

这条命令会：

1. 清理之前的构建产物
2. 运行单元测试（Surefire插件）并收集覆盖率数据
3. 运行集成测试（Failsafe插件）并收集覆盖率数据
4. 生成Jacoco的二进制文件和报告

验证结果 #

执行命令后，你可以在每个子模块的target/目录下找到二进制覆盖率文件jacoco.exec，同时在target/site/jacoco/目录下找到HTML格式的覆盖率报告（打开index.html即可在浏览器中查看详细的覆盖率统计）。

注意：不要意外跳过测试！如果命令行传入了-DskipTests=true，测试不会执行，Jacoco也无法生成任何覆盖率数据。

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