使用Gradle时PowerMock、Jacoco与SonarQube覆盖率统计失效问题排查

嘿，这个覆盖率不匹配的问题我之前也碰到过，结合你的技术栈（Java9+Gradle4.10+Jacoco+PowerMock），咱们一步步来搞定它：

问题根源先搞懂 #

你看到的Classes in bundle 'Example' do no match with execution data报错，本质是Jacoco的执行数据（.exec文件）和编译后的class文件哈希不一致。原因主要有两个：

• PowerMock会大幅篡改测试目标类的字节码，和Jacoco的插桩逻辑冲突
• Java9的模块系统+Gradle4的classesDir弃用适配，导致class文件路径或编译后的字节码结构出现变化

解决方案（保留Java9+Gradle4的前提下） #

方案1：升级Jacoco+调整离线插桩配置

Jacoco 0.8.4对Java9的兼容性一般，先升级到兼容版本，再修正Gradle4的离线插桩配置：

jacoco {
    toolVersion = "0.8.7" // 0.8.7对Java9的字节码和模块支持更完善
}

// 定义离线插桩任务
task jacocoOfflineInstrument(type: JacocoInstrumentation) {
    dependsOn classes
    destinationDir = file("$buildDir/classes/java/main-instrumented")
    // 替换弃用的classesDir为classesDirs
    classFiles = files(sourceSets.main.output.classesDirs)
}

test {
    dependsOn jacocoOfflineInstrument
    // 强制测试时使用插桩后的class文件
    classpath = files(jacocoOfflineInstrument.destinationDir) + classpath
    // 关闭在线插桩，避免和离线插桩冲突
    jacoco {
        enabled = false
    }
}

jacocoTestReport {
    dependsOn test
    // 报告生成用原始class文件，而非插桩后的
    classDirectories.setFrom(files(sourceSets.main.output.classesDirs))
    executionData.setFrom(file("$buildDir/jacoco/test.exec"))
}

执行时先跑./gradlew clean jacocoTestReport，彻底清理缓存的class文件和旧执行数据。

方案2：替换PowerMock为Mockito（减少字节码冲突）

如果你的测试逻辑不需要PowerMock的静态方法/私有方法mock能力，换成Mockito 3.x是更省心的选择——它支持Java9，且不会像PowerMock那样深度篡改字节码：

1. 移除PowerMock相关依赖，添加Mockito：

testImplementation 'org.mockito:mockito-core:3.12.4'
testImplementation 'org.mockito:mockito-junit4:3.12.4' // 适配JUnit4，JUnit5换mockito-junit-jupiter

2. 重构测试代码：比如把@RunWith(PowerMockRunner.class)换成Mockito的runner，静态方法mock用Mockito 3.4+支持的mockStaticAPI。

方案3：适配PowerMock+Jacoco的协同配置（必须保留PowerMock时）

如果你必须用PowerMock，要确保版本兼容Java9，且调整agent加载顺序：

test {
    // 先加载Jacoco agent，再加载PowerMock agent，避免字节码篡改冲突
    jvmArgs = [
        "-javaagent:${classpath.find { it.name.contains('jacocoagent') }.absolutePath}=destfile=$buildDir/jacoco/test.exec",
        "-javaagent:${classpath.find { it.name.contains('powermock-module-javaagent') }.absolutePath}"
    ]
    // 只精确标注需要mock的类，减少字节码修改范围
}

注意要使用PowerMock 2.0.9+版本，它是首个支持Java9的PowerMock版本。

验证步骤 #

1. 执行./gradlew clean清空所有旧编译产物和执行数据
2. 跑./gradlew jacocoTestReport生成报告
3. 查看build/reports/jacoco/test/html/index.html确认报告是否正常生成

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