Gradle配置Jacoco报错：找不到jacocoTestReport()方法

我帮你排查下这个Jacoco配置的问题，你遇到的报错本质是Gradle API版本不兼容导致的——旧教程里的写法可能用了已经被新版Gradle弃用的任务创建方式，直接复制粘贴就会出现方法找不到的问题。结合你的Java+Kotlin项目（看起来是Android项目，因为提到了testDebugUnitTest任务），我给你适配新版Gradle的正确配置方案：

第一步：确认Jacoco插件已正确引入 #

首先在模块级的build.gradle（如果是Android项目）或根目录build.gradle（普通JVM项目）中，确保已经应用Jacoco插件：

// Android项目模块级build.gradle
plugins {
    id 'com.android.application' // 或 'com.android.library'
    id 'kotlin-android'
    id 'jacoco' // 关键：引入Jacoco插件
}

// 普通Java/Kotlin JVM项目的build.gradle
plugins {
    id 'java'
    id 'org.jetbrains.kotlin.jvm'
    id 'jacoco'
}

第二步：用新版Gradle API注册Jacoco报告任务 #

旧教程里直接调用jacocoTestReport()的方式已经被弃用，新版Gradle推荐用tasks.register()来注册任务，这也是解决你报错的核心。

针对Android项目的配置 #

android {
    // 保留你原有的Android配置（compileSdk、defaultConfig等）

    buildTypes {
        debug {
            // 开启Debug构建的测试覆盖率支持
            testCoverageEnabled true
        }
    }

    testOptions {
        unitTests.all {
            // 解决Kotlin无位置类的覆盖率统计问题
            jacoco.includeNoLocationClasses = true
        }
    }
}

// 注册Jacoco测试报告任务
tasks.register('jacocoTestReport', JacocoReport) {
    // 依赖Debug单元测试任务，确保先跑测试再生成报告
    dependsOn 'testDebugUnitTest'

    // 指定要生成的报告格式（XML用于CI，HTML用于本地查看）
    reports {
        xml.required = true
        html.required = true
    }

    // 过滤不需要统计覆盖率的文件（比如R类、BuildConfig、测试类等）
    def fileFilter = ['**/R.class', '**/R$*.class', '**/BuildConfig.*', '**/Manifest*.*', '**/*Test*.*', 'android/**/*.*']
    // 指定Java和Kotlin编译后的class文件目录
    def debugJavaClasses = fileTree(dir: "${buildDir}/intermediates/javac/debug", excludes: fileFilter)
    def debugKotlinClasses = fileTree(dir: "${buildDir}/tmp/kotlin-classes/debug", excludes: fileFilter)

    // 配置覆盖率统计的源文件、class文件和执行数据
    sourceDirectories.from = files([android.sourceSets.main.java.srcDirs, android.sourceSets.main.kotlin.srcDirs])
    classDirectories.from = files([debugJavaClasses, debugKotlinClasses])
    executionData.from = fileTree(dir: buildDir, includes: [
            'jacoco/testDebugUnitTest.exec', // 单元测试执行数据
            'outputs/code_coverage/debugAndroidTest/connected/*coverage.ec' // 仪器化测试执行数据（可选）
    ])
}

针对普通Java/Kotlin JVM项目的配置 #

如果你是普通JVM项目（非Android），用下面的配置：

tasks.register('jacocoTestReport', JacocoReport) {
    dependsOn 'test' // 依赖普通单元测试任务

    reports {
        xml.required = true
        html.required = true
    }

    def fileFilter = ['**/*Test*.*']
    def mainJavaClasses = fileTree(dir: "${buildDir}/classes/java/main", excludes: fileFilter)
    def mainKotlinClasses = fileTree(dir: "${buildDir}/classes/kotlin/main", excludes: fileFilter)

    sourceDirectories.from = files(sourceSets.main.java.srcDirs, sourceSets.main.kotlin.srcDirs)
    classDirectories.from = files(mainJavaClasses, mainKotlinClasses)
    executionData.from = fileTree(dir: buildDir, includes: ['jacoco/test.exec'])
}

第三步：验证配置 #

配置完成后，执行以下命令生成覆盖率报告：

# Android项目
./gradlew jacocoTestReport

# 普通JVM项目
./gradlew clean test jacocoTestReport

执行成功后，报告会生成在build/reports/jacoco/jacocoTestReport/html目录下，打开index.html就能查看详细的覆盖率数据。

额外检查点 #

• 确保你的Gradle版本在5.0以上（tasks.register()是Gradle 5.0引入的API），如果版本过低，建议升级Gradle到稳定版
• 确认依赖的测试任务名称正确：Android项目是testDebugUnitTest，普通项目是test，不要写错

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