读取Android JaCoCo执行数据文件时遇Unknown block type错误

一、修复自定义Jacoco任务的配置问题 #

你的自定义coverageReport任务路径存在AGP版本兼容性问题，调整为以下通用配置：

task coverageReport(type: JacocoReport, dependsOn: ['connectedDebugAndroidTest']) {
    // 源码目录：包含java和kotlin（如果项目使用Kotlin）
    sourceDirectories.setFrom(files(
        android.sourceSets.main.java.srcDirs,
        android.sourceSets.main.kotlin.srcDirs
    ))
    // 类文件目录：过滤无需统计的冗余类
    classDirectories.setFrom(fileTree(
        dir: "${project.buildDir}/intermediates/classes/debug",
        excludes: [
            '**/R.class',
            '**/R$*.class',
            '**/BuildConfig.class',
            '**/*Test*.class'
        ]
    ))
    // 执行数据：确保仅读取测试完成后生成的.ec文件
    executionData.setFrom(fileTree(
        dir: project.buildDir,
        includes: [
            "outputs/code_coverage/debugAndroidTest/connected/*/*.ec"
        ]
    ))
    // 指定报告输出格式
    reports {
        xml.required.set(true)
        html.required.set(true)
    }
}

关键调整点：

• 让任务依赖connectedDebugAndroidTest，确保测试完全执行完毕再生成报告
• 替换类文件路径为intermediates/classes/debug，适配AGP新版本的编译产物结构
• 过滤无关类，避免统计无效代码干扰覆盖率结果

二、启用Android Test Orchestrator强化测试隔离 #

Test Orchestrator会为每个测试类启动独立进程，既满足测试用例隔离需求，又能从根源避免进程间覆盖率数据写入冲突，解决.ec文件损坏问题：

1. 在build.gradle中配置：

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        testInstrumentationRunnerArguments useTestStorageService: 'true'
        // 启用Orchestrator
        testInstrumentationRunnerArguments orchestrator: 'true'
    }

    buildTypes {
        debug {
            testCoverageEnabled true
        }
    }

    // 添加Orchestrator依赖
    dependencies {
        androidTestUtil 'androidx.test:orchestrator:1.4.2'
    }
}

2. 移除clearPackageData，因为Orchestrator本身会在每个测试后自动清理应用数据，无需重复配置

三、禁用测试并行执行 #

并行测试可能导致多个进程同时写入覆盖率数据，引发文件损坏，在gradle.properties中添加：

android.testOptions.execution = "SINGLE_THREADED"

四、临时规避：跳过损坏的.ec文件 #

如果以上方法仍有概率出现问题，可添加预处理任务验证.ec文件有效性，自动跳过损坏文件：

task validateExecFiles {
    doLast {
        def execFiles = fileTree(dir: project.buildDir, includes: ["outputs/code_coverage/debugAndroidTest/connected/*/*.ec"])
        execFiles.each { file ->
            try {
                def input = new FileInputStream(file)
                def reader = new org.jacoco.core.data.ExecutionDataReader(input)
                reader.read()
                input.close()
            } catch (Exception e) {
                println "Skipping corrupted exec file: ${file.name}"
                file.delete()
            }
        }
    }
}

// 让覆盖率报告任务依赖验证任务
coverageReport.dependsOn(validateExecFiles)

原因分析 #

Unknown block type错误本质是Jacoco执行数据文件（.ec）未被完整写入，常见触发场景：

• 测试进程被强制终止（如系统资源不足、测试超时），导致文件写入中断
• 多测试进程共享资源，覆盖率数据写入时发生冲突
• 自定义Jacoco任务在测试未完全结束时就开始读取文件

替代方案 #

如果Jacoco稳定性始终无法满足需求，可尝试：

1. 使用AGP内置覆盖率报告：执行./gradlew createDebugCoverageReport，官方内置任务兼容性更好，无需自定义配置
2. 优先保障单元测试覆盖率：Jacoco对单元测试的支持更成熟，若插桩测试覆盖率的优先级不高，可先聚焦单元测试
3. 云端测试覆盖率：借助Firebase Test Lab执行插桩测试，云端环境稳定性更高，且能自动生成覆盖率报告

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