JaCoCo覆盖率报告中已过滤方法仍显示未覆盖是否符合预期？

这个现象不属于预期表现，是配置环节缺失导致的规则未生效，0.8.8版本的JaCoCo本身完全支持通过自定义注解排除指定方法的覆盖率统计。

问题排查点 #

• 自定义注解本身无问题：你定义的ExcludeFromJacocoGeneratedReport注解配置符合要求，RUNTIME级保留策略+方法级目标的写法不需要调整。
• 核心缺失项：仅定义注解不会自动被JaCoCo识别，必须在构建工具的JaCoCo插件配置中，明确声明需要过滤带该注解的代码元素。

对应配置示例 #

Maven环境配置 #

在pom.xml的JaCoCo插件配置段添加注解排除规则，注意写对注解的全限定类名：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.8</version>
    <configuration>
        <!-- 原有其他排除规则可保留 -->
        <excludes>
        </excludes>
        <!-- 新增自定义注解排除配置 -->
        <annotationExcludes>
            <annotationExclude>com.spotnana.common.ExcludeFromJacocoGeneratedReport</annotationExclude>
        </annotationExcludes>
    </configuration>
    <!-- 原有执行目标配置无需修改 -->
</plugin>

Gradle环境配置 #

在build.gradle中添加注解排除参数：

jacoco {
    toolVersion = "0.8.8"
}
test {
    jacoco {
        excludeAnnotations = ['com.spotnana.common.ExcludeFromJacocoGeneratedReport']
    }
}

生效注意事项 #

• 修改配置后必须先执行clean清空旧构建产物，再重新执行测试、生成覆盖率报告，旧缓存的class文件不会应用新的排除规则，会导致配置失效。
• 配置中填写的注解全限定类名必须和注解实际的包路径、类名完全一致，匹配失败则规则不生效。
• 当前注解仅配置了方法级生效目标，只有标注在具体方法上才会被排除，如果需要支持类级别的整体排除，可以给注解的@Target追加ElementType.TYPE枚举值。

规则正常生效后，被标注的方法不会再在HTML报告中被标记为未覆盖的红色，也不会计入未覆盖代码的统计口径。

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