SpringBoot项目Jenkins构建中Jacoco Agent依赖解析失败求助

在Jenkins中构建SpringBoot应用时，尝试通过Jacoco生成测试报告，已通过插件管理器高级选项卡上传Jacoco插件，但构建过程中始终报错。
环境参数：

• Jenkins版本：2.190.3
• Jacoco Jenkins插件版本：3.0.4~3.0.8（全版本尝试均报错）
• Gradle版本：7.0.2
• Java版本：11

（用户提供的build.gradle配置、Jenkins构建脚本、具体错误日志可补充在此处）

1. 检查build.gradle的Jacoco配置 #

确保Jacoco插件正确引入且报告生成规则配置到位，参考正确示例：

plugins {
    id 'org.springframework.boot' version '2.5.x'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
    id 'jacoco'
}

jacoco {
    toolVersion = '0.8.7' // 与Jenkins插件版本匹配，3.x系列插件适配0.8.5+版本
}

test {
    useJUnitPlatform()
    finalizedBy jacocoTestReport // 测试完成后自动触发报告生成
}

jacocoTestReport {
    dependsOn test
    reports {
        xml.required = true // Jenkins Jacoco插件依赖XML格式报告解析，必须开启
        html.required = true
    }
}

重点：若未开启xml.required = true，Jenkins插件将无法找到可解析的报告文件，直接报错。

2. Jenkins构建脚本与插件配置检查 #

• 构建命令需明确触发Jacoco报告生成：执行gradle clean test jacocoTestReport，而非仅gradle clean build（默认build任务不会自动关联jacocoTestReport）
• 构建后步骤的Jacoco插件配置：选择「Record JaCoCo coverage report」，准确指定XML报告路径，例如**/build/reports/jacoco/test/jacocoTestReport.xml，路径错误会导致插件找不到报告文件。

3. 版本兼容问题处理 #

Jenkins 2.190.3属于旧版本，与Jacoco 3.x系列插件存在兼容性冲突：

• 降级Jacoco Jenkins插件至2.5.4版本（该版本对旧Jenkins兼容性更好）
• 同步调整Gradle中jacoco.toolVersion至0.8.5左右，确保工具与插件版本匹配，避免因版本差异导致解析失败。

4. 临时规避方案 #

若上述配置调整后仍报错，可绕过Jenkins Jacoco插件，直接用HTML报告展示：

1. 确保build.gradle中jacocoTestReport已开启HTML报告生成
2. 在Jenkins构建后步骤添加「Publish HTML reports」插件，指定HTML报告目录为**/build/reports/jacoco/test/html，设置自定义报告标题即可完成展示。

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