多源码目录+build-helper-maven-plugin下Clover部分覆盖率指标为0如何排查

嘿，这个问题我之前帮朋友排查过好几次——核心原因是Clover默认只会盯着Maven原生的源码路径（比如src/main/java、src/test/java），完全不会自动感知build-helper-maven-plugin新增的那些源码目录。那些没被扫描到的代码自然不会被Clover做插桩处理，对应的覆盖率、代码行数之类的指标就会显示为0。

下面给你具体的解决配置：

1. 给Clover显式配置所有源码目录 #

你需要在maven-clover-plugin的配置里，把所有源码目录（包括原生的和build-helper新增的）都列出来。比如你的项目加了src/custom-java和src/another-src两个额外源码目录，配置就像这样：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-clover-plugin</artifactId>
    <version>4.4.1</version> <!-- 替换成你实际使用的版本 -->
    <configuration>
        <!-- 配置主源码目录 -->
        <sources>
            <source>src/main/java</source>
            <source>src/custom-java</source>
            <source>src/another-src</source>
        </sources>
        <!-- 如果有新增的测试目录，也要同步配置这里 -->
        <testSources>
            <testSource>src/test/java</testSource>
            <testSource>src/custom-test</testSource>
        </testSources>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>instrument</goal>
                <goal>clover</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 确保build-helper的执行顺序在Clover之前 #

必须让build-helper-maven-plugin先完成源码目录的添加，Clover再开始扫描。你可以通过指定执行阶段来控制顺序：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>3.3.0</version>
    <executions>
        <execution>
            <id>add-source</id>
            <phase>generate-sources</phase> <!-- 这个阶段在Clover插桩之前执行 -->
            <goals>
                <goal>add-source</goal>
            </goals>
            <configuration>
                <sources>
                    <source>src/custom-java</source>
                    <source>src/another-src</source>
                </sources>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 验证配置并重新生成报告 #

先清理掉之前的构建缓存，再重新运行Clover命令：

mvn clean clover:instrument clover:clover

这时候再去看生成的clover.xml，所有源码目录的指标应该都能正常统计了。

额外提一句：如果是多模块项目，记得每个模块都要检查Clover配置，或者在父pom里统一配置（如果适合你的项目结构的话）。

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