IntelliJ使用Gradle构建运行时断点无法命中及测试覆盖率失效问题

根因说明 #

该问题由两个核心原因导致：

1. Gradle 7.2 对 Java 17 的适配存在缺陷，JPMS 模块系统下测试/运行任务fork的子进程无法正确接收 IDE 注入的 JDWP 调试参数、Jacoco 覆盖率统计参数
2. 复合构建（includeBuild）场景下，默认配置不会把根项目的任务规则同步到引入的子构建项目，导致子项目的测试、运行任务没有继承调试/覆盖率相关配置

修复步骤 #

1. 全局统一任务配置 #

在外层根项目的build.gradle中添加如下配置，将调试、覆盖率规则同步到所有include的子构建项目：

allprojects {
    tasks.withType(Test) {
        // 禁用任务执行缓存，避免命中缓存跳过实际代码执行
        outputs.upToDateWhen { false }
        // 自动识别IDE调试模式，传递调试参数到测试进程
        debug = System.getProperty('gradle.test.debug', 'false').toBoolean()
        // 开启Jacoco覆盖率支持
        jacoco {
            enabled = true
        }
    }
    tasks.withType(JavaExec) {
        // 适配main函数运行场景的调试参数传递
        debug = System.getProperty('gradle.debug', 'false').toBoolean()
        outputs.upToDateWhen { false }
    }
}

// 同步配置到所有include的子构建
gradle.includedBuilds.each { build ->
    project(":${build.name}").tasks.withType(Test).configureEach(testTask -> {
        testTask.outputs.upToDateWhen { false }
        testTask.debug = System.getProperty('gradle.test.debug', 'false').toBoolean()
    })
}

2. 升级Gradle版本（推荐） #

Gradle 7.2 对Java 17的支持存在多个已知兼容性问题，建议升级到7.6.3及以上的7.x稳定版本，升级后无需额外配置即可解决参数传递问题。
升级方式：修改根项目下gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl配置项即可。

3. IntelliJ配置校验 #

确认以下配置项正确：

• 打开设置 > 构建、执行、部署 > 构建工具 > Gradle，构建和运行使用的Gradle选择wrapper 任务配置文件，避免本地Gradle版本和项目版本不一致
• 测试运行配置中添加带有测试运行器的模块类路径选项保持勾选
• 覆盖率统计工具选择Jacoco，和Gradle任务配置保持一致

临时验证方案 #

如果暂时不想修改配置，可以在调试测试时，右键对应子项目的testGradle任务，选择修改运行配置，在任务参数中添加--debug-jvm后再启动调试，即可命中断点。 #

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