配置Jacoco覆盖率阈值后Jenkins构建未失败的原因排查

你的核心问题是Jacoco验证任务未正确关联到集成测试的覆盖率数据，导致即使设置100%覆盖率要求也不会触发构建失败。以下是具体原因和修复步骤：

1. 默认验证任务绑定的是单元测试数据 #

jacocoTestCoverageVerification 默认会读取**test任务**（单元测试）生成的Jacoco执行数据，但你在Jenkins中运行的是jacocoIntegrationReport（集成测试报告），这意味着验证任务可能在读取旧的单元测试数据，甚至没有数据可读取——Jacoco在无有效执行数据时不会触发违规失败。

2. 修复步骤 #

步骤1：让验证任务关联集成测试的执行数据 #

在build.gradle中，为jacocoTestCoverageVerification指定集成测试任务的执行数据：

jacocoTestCoverageVerification {
    // 绑定集成测试任务的Jacoco数据（假设你的集成测试任务名为integrationTest）
    executionData tasks.integrationTest
    
    violationRules {
        rule {
            limit {
                minimum = 0.9
            }
            // 强制指定需要检查覆盖率的类范围，避免无关代码干扰
            includes = ['com/yourteam/**', 'your/package/path/**']
        }
    }
}

步骤2：确保集成测试任务启用Jacoco #

如果你的集成测试任务是自定义的，需要明确开启Jacoco：

// 假设你的集成测试任务名为integrationTest
task integrationTest(type: Test) {
    // 这里配置集成测试的源码、类路径等（根据你的项目调整）
    testClassesDirs = sourceSets.integrationTest.output.classesDirs
    classpath = sourceSets.integrationTest.runtimeClasspath
    
    // 启用Jacoco生成执行数据
    jacoco {
        enabled = true
    }
}

步骤3：让验证任务依赖集成测试任务 #

确保验证任务在集成测试执行完成后再运行，避免读取空数据：

jacocoTestCoverageVerification.dependsOn integrationTest

步骤4：优化Jenkins流水线调用 #

可以合并Gradle命令，减少任务调用次数，同时确保执行顺序：

stage('Integration tests coverage report - Windows') {
    when { expression { env.OS == 'BAT' }}
    steps {
        dir('') {
             bat 'gradlew.bat integrationTest jacocoIntegrationReport jacocoTestCoverageVerification'
        }
    }
}

3. 验证方法 #

运行Jenkins构建后，查看jacocoTestCoverageVerification任务的日志：

• 如果日志显示Loading execution data from [.../build/jacoco/integrationTest.exec]，说明数据已正确关联
• 如果出现Rule violated for bundle ...: instructions covered ratio is 0.XX, expected minimum is 0.9，说明验证规则已生效

内容的提问来源于stack exchange，提问作者Fábio Pires