Gradle 7.0迁移：如何从compileClasspath中移除指定JAR包

原方案失效原因 #

Gradle 7.0版本对配置和任务属性的初始化时机、派生逻辑做了调整，原方案失效的核心原因有两点：

1. sourceSets.main.compileClasspath现在是从implementation、compileOnly等上游配置派生的只读视图，直接做减法操作不会修改上游配置，也不会同步到实际的Java编译任务类路径
2. afterEvaluate的执行时机晚于编译任务的classpath属性初始化，修改不会被任务捕获

可用解决方案 #

方案1：直接过滤Java编译任务的类路径 #

适合不知道依赖坐标、仅知道目标Jar包名/路径的场景，直接修改编译任务的classpath属性：

// 仅处理main代码的编译任务
tasks.named<JavaCompile>("compileJava") {
    // 可根据实际需求调整判断逻辑，比如匹配Jar的绝对路径
    classpath = classpath.filter { jarFile ->
        jarFile.name != "the_jar_to_remove.jar"
    }
}
// 如果需要同时处理测试等所有Java编译任务，可以用批量匹配的写法
tasks.withType<JavaCompile> {
    classpath = classpath.filter { jarFile ->
        jarFile.name != "the_jar_to_remove.jar"
    }
}

方案2：从编译配置源头排除 #

适合知道目标依赖Maven坐标的场景，直接给编译配置添加排除规则，从源头阻止依赖被加入类路径：

configurations {
    compileClasspath {
        // 替换为目标依赖的实际groupId和artifactId
        exclude(group = "com.example.group", module = "target-dependency-name")
    }
}

该方案优先级更高，会作用于所有依赖compileClasspath的任务，不需要单独修改每个任务的属性。

内容的提问来源于stack exchange，提问作者Julien H. - SonarSource Team