Gradle多项目Jacoco离线插装报错：类已被插装问题求助

这个错误的核心原因是同一个类被Jacoco重复插装了——要么是默认的在线插装和你手动配置的离线插装同时生效，要么是原始类和插装后的类同时出现在测试的classpath中，导致JVM加载了两份插装后的类。

下面是针对你的配置的修复方案：

关键修复步骤 #

1. 禁用子项目的默认Jacoco在线插装 #

默认情况下，jacoco插件会为test任务启用在线插装，这和你的离线插装逻辑冲突。在子项目配置中关闭它：

subprojects {
    dependencies { testCompile 'junit:junit:4.11' }
    
    // 新增：关闭默认在线插装，避免和离线插装冲突
    test {
        jacoco {
            enabled = false
        }
    }

    jacocoTestReport {
        println 'first here in jacocoTestReport'
        additionalSourceDirs = files(sourceSets.main.allSource.srcDirs)
        sourceDirectories = files(sourceSets.main.allSource.srcDirs)
        // 改为指向插装后的类目录，而非原始输出
        classDirectories = files(new File(buildDir, 'instrumentedClasses'))
        println 'in jacocoTestReport : ' + sourceSets.main.output
        reports { html.enabled = true xml.enabled = true csv.enabled = false }
    }
}

2. 修复instrument任务的classpath替换逻辑 #

你之前注释掉了classpath替换代码，导致原始类和插装类同时存在于测试classpath中。修改instrument任务，确保每个子项目的测试classpath只使用插装后的类：

task instrument(dependsOn: subprojects*.classes, project.configurations.jacocoAnt) {
    subprojects.each { lSubProject ->
        def sourceSet = lSubProject.sourceSets.main
        inputs.files sourceSet.output.classesDirs
        File outputDir = new File(lSubProject.buildDir, 'instrumentedClasses')

        doFirst {
            project.delete(outputDir)
            ant.taskdef(
                resource: 'org/jacoco/ant/antlib.xml',
                classpath: project.configurations.jacocoAnt.asPath,
                uri: 'jacoco'
            )

            def instrumented = false
            if (sourceSet.output.classesDirs.files.any { it.exists() }) {
                ant.'jacoco:instrument'(destdir: outputDir) {
                    fileset(dir: sourceSet.output.classesDir)
                }
                // 正确替换子项目的测试classpath，移除原始类目录，添加插装后的目录
                lSubProject.sourceSets.test.runtimeClasspath -= sourceSet.output.classesDirs
                lSubProject.sourceSets.test.runtimeClasspath += files(outputDir)
                instrumented = true
            }
            if (instrumented) {
                // 给子项目的test任务添加jvm参数，而非根项目
                lSubProject.test.jvmArgs += '-noverify'
            }
        }
    }
}

3. 调整根报告的依赖和class目录配置 #

确保jacocoRootReport只依赖子项目的test任务，并且正确收集插装后的类：

task jacocoRootReport(type: org.gradle.testing.jacoco.tasks.JacocoReport) {
    dependsOn subprojects.test
    additionalSourceDirs = files(subprojects.sourceSets.main.allSource.srcDirs)
    sourceDirectories = files(subprojects.sourceSets.main.allSource.srcDirs)
    // 统一收集所有子项目的插装类目录，过滤不存在的目录
    classDirectories = files(subprojects.collect { new File(it.buildDir, 'instrumentedClasses') }.findAll { it.exists() })
    // 过滤存在的执行数据文件
    executionData = files(subprojects.jacocoTestReport.executionData).filter { it.exists() }
    reports { html.enabled = true xml.enabled = true csv.enabled = false }
}

4. 确保测试任务依赖正确的插装逻辑 #

替换原来根项目的test依赖配置，让每个子项目的test任务都依赖根项目的instrument任务：

subprojects {
    test.dependsOn rootProject.instrument
}

最终执行命令 #

先清理旧的构建产物，避免残留插装类导致的问题，再执行根报告：

./gradlew clean jacocoRootReport --no-daemon --stacktrace

为什么这些修改有效？ #

• 关闭默认在线插装，彻底避免和离线插装重复处理类文件
• 彻底替换测试classpath，只保留插装后的类，消除JVM加载重复类的可能
• 统一收集插装后的类目录，确保覆盖率报告基于正确的插装结果

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