迁移到Java 17后GitHub Action环境下Jacoco覆盖率结果不一致是什么原因

核心适配问题（匹配你当前版本栈） #

你使用的Jacoco 0.8.7仅对Java 17提供初步支持，存在大量字节码识别缺陷：Java 17引入的密封类、instanceof模式匹配、JVM内置空指针检查等新特性生成的特殊字节码，0.8.7版本经常会误判为未覆盖行，甚至直接跳过部分类的覆盖率统计。当本地和CI环境的JVM字节码生成参数存在细微差异时，就会触发该bug，导致两边统计结果偏差极大。 #

其他常见触发原因 #

• 测试执行范围差异 #

  CI环境可能因为环境变量、配置参数的差异，跳过部分测试用例：
  • 标注了条件执行的测试（如仅本地执行、需要特定环境变量的测试）在CI环境被跳过
  • 测试资源加载失败导致部分用例静默失败，未实际执行对应业务代码
    排查方式：在CI构建命令中添加--info参数输出测试执行日志，对比本地与CI的测试用例执行、跳过数量是否完全一致。

• Gradle构建缓存干扰 #

  即使执行./gradlew clean build，如果CI配置了全局Gradle缓存，可能复用旧版本的类文件、Jacoco执行数据，导致覆盖率统计并非基于本次代码生成。
  修复方案：构建命令添加--no-build-cache参数禁用构建缓存，确保所有产物均为本次构建全新生成。

• 字节码增强逻辑差异 #

  若项目使用Lombok、Spring AOP、MapStruct等字节码增强工具，不同环境的增强逻辑可能存在差异：
  • 依赖版本存在微小差异（如快照版本动态更新），导致生成的字节码结构不同
  • CI环境的JVM启动参数开启了额外字节码修改逻辑，导致Jacoco插桩位置和本地不一致
    排查方式：分别导出本地和CI构建生成的class文件，对比同一类的字节码结构是否一致。

• Jacoco插桩逻辑冲突 #

  你添加的noverifyJVM参数可能和Jacoco插桩逻辑冲突，导致部分类的覆盖率统计失效；同时如果CI环境的Gradle任务执行顺序和本地不同，可能出现部分类未被正确插桩的情况。
  修复方案：移除noverify参数，显式在Gradle配置中指定Jacoco插桩目标为所有业务源集，确保所有需要统计的类都被正确插桩。

优先级最高的修复动作 #

直接将Jacoco插件版本升级至0.8.8及以上，该版本完整修复了Java 17字节码的覆盖率统计问题，也是Gradle 7.3+官方适配的Jacoco版本，绝大多数同类问题升级后即可解决。

内容的提问来源于stack exchange，提问作者Mário Santos Sousa