JUnit5结合Jacoco生成覆盖率时@Transactional类匹配异常求助

这个问题我之前在项目里也遇到过，核心矛盾在于Spring事务代理的动态生成特性和Jacoco字节码插桩的匹配要求之间的冲突，我给你梳理下解决思路和具体方案：

为什么会出现这个错误？ #

当你的SampleService方法标注@Transactional时，Spring会自动生成一个代理类（要么是基于接口的JDK动态代理，要么是基于子类的CGLIB代理）来接管事务逻辑。而Jacoco在测试运行时，会对原始的类文件进行字节码插桩，用来收集覆盖率数据。

但你之前的Gradle配置里，jacocoTestReport生成报告时用的是未插桩的原始类文件，这就导致Jacoco收集的执行数据（来自插桩后的类）和报告用的类文件字节码不匹配，最终抛出Classes in bundle do not match with execution data的错误，覆盖率直接显示为0。

解决方案：修正Jacoco报告的类目录配置 #

最直接的解决方法是让jacocoTestReport使用测试任务中已经插桩过的类文件，而不是原始类。修改你的Gradle子项目配置如下：

subprojects {
    test {
        useJUnitPlatform()
    }
    jacocoTestReport {
        // 直接引用测试任务生成的执行数据和插桩后的类目录，保证一致性
        executionData.from = tasks.test.jacoco.executionData
        classDirectories.from = tasks.test.jacoco.classDirectories
        
        // 排除测试类（避免统计测试代码的覆盖率）
        afterEvaluate {
            classDirectories.setFrom(files(classDirectories.files.collect {
                fileTree(dir: it, exclude: '*Test.java')
            }))
        }
        
        reports {
            html.enabled = true
            xml.enabled = true
            csv.enabled = false
        }
    }
}

可选优化：强制Spring使用CGLIB代理 #

如果上述配置后仍有小概率问题，可以强制Spring使用CGLIB代理（默认策略是类有接口则用JDK代理，否则用CGLIB），这样代理类是原始类的子类，Jacoco更容易追踪到原始类的方法执行：

在你的Spring Boot主类或者测试类上添加注解：

@EnableTransactionManagement(proxyTargetClass = true)

验证步骤 #

1. 先清理之前的构建产物，避免残留问题：

   ./gradlew clean
   

2. 运行测试并生成覆盖率报告：

   ./gradlew test jacocoTestReport
   

3. 打开生成的HTML报告（路径：子项目目录/build/reports/jacoco/test/html/index.html），你会发现带@Transactional的方法已经能正确统计覆盖率了。

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