多模块Maven项目中Jacoco无法找到类目录且生成空HTML报告的配置解决方案咨询

我看了你的问题和项目配置，核心问题出在Jacoco插件的配置逻辑上，尤其是路径引用和参数使用的错误，下面一步步帮你修正：

一、先揪出核心配置错误 #

你在父模块的jacoco-site执行中犯了两个关键错误：

1. 用文件系统路径作为<includes>的值：Jacoco的<includes>是用来匹配类的全限定名（比如com/yourcompany/**），不是文件系统的目录路径！你之前写的${project.basedir}/../multi-module-core/target/classes/**完全不符合它的语法，这就是Jacoco提示“缺少类目录”的主因。
2. destFile和dataFile的路径混乱：父模块里指定destFile到core模块的target，又在report阶段引用tests模块的jacoco.exec，逻辑上就绕晕了，应该让每个模块的jacoco.exec生成在自己的target目录，避免路径冲突。

二、分步修正配置 #

1. 重构父模块的Jacoco插件配置 #

把父模块里的Jacoco配置简化，只保留prepare-agent来统一注入测试代理，不要在父模块里做报告生成：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.10</version>
    <executions>
        <execution>
            <id>prepare-agent</id>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <configuration>
                <!-- 让每个模块的jacoco.exec生成在自己的target下，避免覆盖 -->
                <destFile>${project.build.directory}/jacoco.exec</destFile>
            </configuration>
        </execution>
    </executions>
</plugin>

同时修正父模块的surefire插件配置——你之前写了两个<argLine>，这会导致Jacoco的代理参数被覆盖，合并成一行：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M3</version>
    <configuration>
        <!-- 把@{argLine}放在最前面，确保Jacoco的代理参数被正确注入 -->
        <argLine>@{argLine} --illegal-access=permit</argLine>
        <trimStackTrace>false</trimStackTrace>
        <skipTests>${skipTests}</skipTests>
        <testFailureIgnore>true</testFailureIgnore>
        <includes>
            <include>**/*Test.java</include>
        </includes>
    </configuration>
</plugin>

2. 确保测试模块依赖核心模块 #

在multi-module-tests的pom.xml里，添加对multi-module-core的依赖，这样测试执行时能关联到业务类，Jacoco也能找到对应的类文件：

<dependencies>
    <dependency>
        <groupId>${project.groupId}</groupId>
        <artifactId>multi-module-core</artifactId>
        <version>${project.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

3. 修复聚合报告模块的配置 #

jacoco-report模块的report-aggregate需要明确指定类文件的目录和数据文件路径，调整配置如下：

<build>
    <plugins>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.10</version>
            <executions>
                <execution>
                    <id>report-aggregate</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>report-aggregate</goal>
                    </goals>
                    <configuration>
                        <!-- 指定测试模块生成的jacoco.exec位置 -->
                        <dataFileIncludes>
                            <dataFileInclude>../multi-module-tests/target/jacoco.exec</dataFileInclude>
                        </dataFileIncludes>
                        <!-- 显式指定核心模块的类文件目录 -->
                        <classDirectories>
                            <classDirectory>${project.basedir}/../multi-module-core/target/classes</classDirectory>
                        </classDirectories>
                        <!-- 可选：过滤要生成报告的类，比如你的业务包路径 -->
                        <includes>
                            <include>你的包前缀/**</include>
                        </includes>
                        <outputDirectory>${project.reporting.outputDirectory}/jacoco-aggregate</outputDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

这里的<classDirectories>才是指定类文件所在目录的正确参数，而<includes>用来过滤你关心的类包。

三、正确执行命令 #

用verify阶段来触发聚合报告的生成，这个阶段会确保所有模块的编译、测试都完成：

mvn clean verify -DskipTests=false

四、额外检查点 #

• 执行命令时，先确认multi-module-core/target/classes目录存在（如果不存在，说明core模块编译失败，先排查编译问题）。
• 不要用硬编码的绝对路径，尽量用Maven内置变量（比如${project.parent.basedir}代表父模块根目录），这样项目换路径也能正常运行。

按照这个配置调整后，Jacoco应该能正确找到类文件，生成包含覆盖数据的聚合报告了。

备注：内容来源于stack exchange，提问作者mrKaczorrro