Gradle如何将默认test sourceset拆分为test目录下的多个细分测试源集

可行性说明 #

该目录结构完全可实现，且不违反Gradle项目约定。Gradle默认的src/<sourceSetName>目录布局只是官方提供的惯例默认值，并非强制约束，框架原生支持自定义任意路径的源集映射，按测试类型拆分独立源集也是中大型Java项目的常见实践。

需要注意：默认的test源集会自动扫描src/test/java下的测试代码，如果你要把src/test作为纯父目录使用，需要手动清空默认test源集的源码、资源扫描路径，避免它误识别子目录下的测试类。

具体配置方案 #

以下配置分别提供Groovy DSL（build.gradle）和Kotlin DSL（build.gradle.kts）两个版本，配置完成后可通过独立命令分别执行两类测试：

• 执行./gradlew unitTest：仅运行单元测试
• 执行./gradlew componentTest：仅运行组件测试

Groovy DSL 配置

plugins {
    id 'java'
    id 'org.springframework.boot' version '当前项目使用的Spring Boot版本'
    id 'io.spring.dependency-management' version '对应依赖管理插件版本'
}

// 其余基础配置（group、sourceCompatibility、业务依赖等）保持原有逻辑即可

sourceSets {
    // 清空默认test源集的扫描路径，将其作为纯父目录
    test {
        java.srcDirs = []
        resources.srcDirs = []
    }
    // 单元测试源集
    unit {
        java.srcDirs = ['src/test/unit/java']
        resources.srcDirs = ['src/test/unit/resources']
        compileClasspath += sourceSets.main.output + configurations.testRuntimeClasspath
        runtimeClasspath += output + compileClasspath
    }
    // 组件测试源集
    component {
        java.srcDirs = ['src/test/component/java']
        resources.srcDirs = ['src/test/component/resources']
        compileClasspath += sourceSets.main.output + configurations.testRuntimeClasspath
        runtimeClasspath += output + compileClasspath
    }
}

// 注册独立的单元测试执行任务
task unitTest(type: Test) {
    description = 'Executes unit test cases'
    group = 'verification'
    testClassesDirs = sourceSets.unit.output.classesDirs
    classpath = sourceSets.unit.runtimeClasspath
}

// 注册独立的组件测试执行任务
task componentTest(type: Test) {
    description = 'Executes component test cases'
    group = 'verification'
    testClassesDirs = sourceSets.component.output.classesDirs
    classpath = sourceSets.component.runtimeClasspath
}

// 可选：将两类测试纳入check生命周期，执行./gradlew check时自动运行所有测试
check.dependsOn unitTest, componentTest

Kotlin DSL 配置

plugins {
    id("java")
    id("org.springframework.boot") version "当前项目使用的Spring Boot版本"
    id("io.spring.dependency-management") version "对应依赖管理插件版本"
}

// 其余基础配置（group、sourceCompatibility、业务依赖等）保持原有逻辑即可

sourceSets {
    // 清空默认test源集的扫描路径，将其作为纯父目录
    test {
        java.setSrcDirs(emptyList<File>())
        resources.setSrcDirs(emptyList<File>())
    }
    // 单元测试源集
    create("unit") {
        java.setSrcDirs(listOf("src/test/unit/java"))
        resources.setSrcDirs(listOf("src/test/unit/resources"))
        compileClasspath += sourceSets.main.get().output + configurations.testRuntimeClasspath.get()
        runtimeClasspath += output + compileClasspath
    }
    // 组件测试源集
    create("component") {
        java.setSrcDirs(listOf("src/test/component/java"))
        resources.setSrcDirs(listOf("src/test/component/resources"))
        compileClasspath += sourceSets.main.get().output + configurations.testRuntimeClasspath.get()
        runtimeClasspath += output + compileClasspath
    }
}

// 注册独立的单元测试执行任务
tasks.register<Test>("unitTest") {
    description = "Executes unit test cases"
    group = "verification"
    testClassesDirs = sourceSets["unit"].output.classesDirs
    classpath = sourceSets["unit"].runtimeClasspath
}

// 注册独立的组件测试执行任务
tasks.register<Test>("componentTest") {
    description = "Executes component test cases"
    group = "verification"
    testClassesDirs = sourceSets["component"].output.classesDirs
    classpath = sourceSets["component"].runtimeClasspath
}

// 可选：将两类测试纳入check生命周期，执行./gradlew check时自动运行所有测试
tasks.named("check") {
    dependsOn("unitTest", "componentTest")
}

补充说明 #

• 如果需要在src/test目录下存放两类测试共用的工具类、通用测试配置，可以不清空默认test源集的路径，单独为其指定公共代码目录（比如src/test/common/java），再将该目录加入unit和component两个源集的编译类路径即可。
• 如果使用JUnit 5作为测试框架，不需要额外修改配置，两个测试任务会默认继承test任务的JUnit平台配置，和原有测试配置体验一致。
• 配置完成后同步Gradle，IDE（IntelliJ IDEA/Eclipse）会自动识别对应源集，标记为测试源码目录，不会出现路径识别异常。

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