Jacoco无法生成覆盖率报告，提示缺失执行数据文件求助

老兄，这个错误我太熟了——Skipping JaCoCo execution due to missing execution data file本质就是Jacoco找不到测试时生成的执行数据文件（默认是target/jacoco.exec），十有八九是Jacoco和Surefire插件的配置没配合好，或者测试压根没跑起来。我给你拆解下问题和解决方案：

核心原因 #

Jacoco生成报告依赖测试阶段收集的执行数据，这个数据是由Jacoco Agent在测试运行时生成的。如果Agent没被正确加载、测试没执行，或者数据文件路径不对，就会报这个错。

正确的插件配置示例 #

你需要确保Jacoco和Surefire的配置联动起来，以下是标准的配置模板：

Jacoco插件配置 #

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.0</version>
    <executions>
        <!-- 关键：在测试前准备Agent，自动设置JVM参数生成jacoco.exec -->
        <execution>
            <id>jacoco-prepare-agent</id>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <!-- 可选：自定义数据文件路径，默认是target/jacoco.exec -->
            <!--
            <configuration>
                <destFile>${project.build.directory}/jacoco.exec</destFile>
            </configuration>
            -->
        </execution>
        <!-- 在测试阶段结束后生成报告 -->
        <execution>
            <id>jacoco-report</id>
            <phase>test</phase>
            <goals>
                <goal>report</goal>
            </goals>
            <configuration>
                <dataFile>${project.build.directory}/jacoco.exec</dataFile>
                <outputDirectory>${project.reporting.outputDirectory}/jacoco</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

Surefire插件配置注意点 #

如果你的Surefire有自定义的argLine（比如设置JVM内存），必须包含${argLine}——因为Jacoco的Agent参数会被自动注入到${argLine}变量中，如果你覆盖了这个参数而没引用它，Agent就不会被加载：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M7</version>
    <configuration>
        <!-- 重点：必须保留${argLine}，否则Jacoco Agent不生效 -->
        <argLine>${argLine} -Xmx512m -Xms256m</argLine>
        <!-- 确保没有开启跳过测试的配置 -->
        <skipTests>false</skipTests>
    </configuration>
</plugin>

排查步骤 #

1. 检查测试是否执行：运行mvn clean test，看日志里有没有类似Tests run: X, Failures: 0, Errors: 0的输出，如果没有，说明测试被跳过了（检查是否有maven.test.skip=true或skipTests=true的参数）。
2. 确认jacoco.exec是否存在：运行测试后，查看target目录下有没有jacoco.exec文件。如果没有，说明Jacoco Agent没生效，回到配置检查prepare-agent目标是否正确绑定，以及Surefire的argLine是否包含${argLine}。
3. 手动触发报告生成：如果测试正常执行且jacoco.exec存在，直接运行mvn jacoco:report，看是否能生成报告（默认在target/site/jacoco目录下）。

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