Gradle根项目生成不必要空JAR问题及配置优化咨询

1. 根项目生成空JAR和build文件夹的原因 #

你在根项目的build.gradle.kts中直接应用了java和jacoco插件，这两个插件会自动为项目绑定一系列构建逻辑：

• java插件会创建jar任务，即便没有源代码，该任务仍会生成仅含清单文件的空JAR包；
• jacoco插件会初始化代码覆盖率相关的任务与输出目录，哪怕没有可测试代码，也会生成空的报告文件夹；
• Gradle所有任务的输出默认都存放在build目录下，因此根项目会自动生成该目录。

2. 配置根项目为非Java管理容器的方案 #

核心思路是不在根项目上激活Java和Jacoco插件，仅将它们作为可用插件提供给子项目，同时调整子项目的插件应用方式。

修改后的根项目build.gradle.kts配置 #

plugins {
    // 仅将插件添加到根项目类路径，不应用到根项目本身
    id("java") apply false
    id("jacoco") apply false
}

configure(subprojects) {
    repositories {
        mavenCentral()
    }

    // 为子项目应用所需插件
    apply(plugin = "java")
    apply(plugin = "jacoco")

    dependencies {
        implementation(platform("org.apache.logging.log4j:log4j-bom:2.20.0"))
        implementation("org.apache.logging.log4j:log4j-api")
        implementation("org.apache.logging.log4j:log4j-core")
        implementation("org.apache.logging.log4j:log4j-slf4j-impl")
        implementation("org.slf4j:slf4j-api:1.7.32")
        testImplementation(platform("org.junit:junit-bom:5.10.0"))
        testImplementation("org.junit.jupiter:junit-jupiter")
        testRuntimeOnly("org.junit.platform:junit-platform-launcher")
    }

    tasks.test {
        useJUnitPlatform()
    }

    tasks.jacocoTestReport {
        dependsOn(tasks.test)
    }

    tasks.jacocoTestCoverageVerification {
        dependsOn(tasks.jacocoTestReport)
    }
}

关于之前apply false配置报错的说明 #

之前报错大概率是因为子项目使用plugins.apply()时，插件未被正确引入到根项目的类路径中。通过在根项目plugins块中声明apply false，插件会被下载并加入类路径，但不会在根项目上激活，此时子项目通过apply(plugin = "...")就能正常调用这些插件。

额外优化建议 #

如果根项目不需要任何构建任务，可进一步禁用根项目的默认任务，避免误执行：

// 在根项目的build.gradle.kts中添加
tasks.withType<Jar> {
    enabled = false
}
tasks.withType<JacocoReport> {
    enabled = false
}
// 或者直接清空根项目的默认任务组
defaultTasks()

配置完成后，根项目将仅作为子项目的管理容器，不会生成空JAR和不必要的build目录，所有Java与Jacoco相关任务仅会在子项目中执行。

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