微服务跨模块Jacoco代码覆盖率统计异常问题求助

1. 确认Jacoco Agent在Service1容器中正确生效 #

• 检查docker-compose.yaml中Service1的JVM参数配置，确保includes精准匹配API层包路径，且挂载目录有读写权限：

  services:
    service1:
      environment:
        - JAVA_OPTS=-javaagent:/jacoco/jacocoagent.jar=destfile=/jacoco/service1.exec,includes=com.yourcompany.service1.api.*,output=tcpserver,port=6300
      volumes:
        - ./jacoco:/jacoco
  

• 进入Service1容器执行ps aux | grep java，确认启动命令中确实包含Jacoco agent参数。

2. 验证测试用例是否真的触发了Service1的API代码 #

• 开启Service1的DEBUG日志，运行Autotests时检查请求是否路由到API层的目标类和方法，避免因路径错误、网关转发问题导致代码未被执行。
• 手动调用Service1的API接口，用Jacoco CLI导出实时覆盖数据验证：

  java -jar jacococli.jar dump --address service1 --port 6300 --destfile service1-dump.exec
  

  若dump出的文件中无API类条目，说明测试未覆盖到这部分代码；若有则问题出在报告生成环节。

3. 检查Gradle jacocoTestReport任务配置 #

• 确保任务正确关联Service1的源码和编译产物，而不是Autotests模块自身的内容：

  jacocoTestReport {
    dependsOn test
    executionData fileTree(project.rootDir).include("**/service1.exec")
    sourceDirectories.from project(":service1").sourceSets.main.java.srcDirs
    classDirectories.from project(":service1").sourceSets.main.output.classesDirs
    reports {
      xml.required = true
      html.required = true
    }
  }
  

• 排查是否存在不合理的exclude规则，避免API类被意外过滤。

4. 核对类路径与Jacoco数据的匹配性 #

• 解压Service1的jar包，确认com/yourcompany/service1/api目录下存在对应class文件，避免编译时包路径变更导致Jacoco无法关联。
• 用Jacoco CLI生成临时报告查看明细：

  java -jar jacococli.jar report service1.exec --classfiles /path/to/service1/classes --sourcefiles /path/to/service1/src/main/java --html temp-report
  

  打开报告检查API类是否存在，以及对应方法的覆盖计数是否为0。

5. 确保Jacoco数据被完整收集 #

• 避免测试结束后容器快速关闭导致数据丢失，可在测试结束后主动dump Jacoco数据，或配置容器停止时触发数据写入。
• 若使用tcpserver模式，确保Autotests模块在测试完成后主动连接Service1的Jacoco端口完成数据导出。

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