如何用jvm-test-suite Gradle插件创建通用测试源集供多套件复用？

问题分析 #

你当前的配置存在几个关键问题：

• sourceSetCommonClasspath定义错误，未包含commonTest的编译输出和类路径，导致其他测试套件无法访问通用测试代码
• 尝试手动修改源目录来复用代码，这会引发重复编译问题，且无法正确共享已编译的通用测试产物

正确配置步骤 #

以下是修正后的完整配置，确保commonTest的源码和资源能被所有测试套件复用：

@file:Suppress("UnstableApiUsage")

plugins {
    `jvm-test-suite`
    kotlin("jvm") // 若使用Kotlin需添加，可根据实际技术栈调整
}

// 注册commonTest源集，配置正确的源码目录与基础依赖
sourceSets {
    register("commonTest") {
        java.srcDir("src/test/common/kotlin")
        resources.srcDir("src/test/common/resources")
        // 允许通用测试代码访问主项目源码
        compileClasspath += sourceSets.main.get().output
        runtimeClasspath += sourceSets.main.get().output
    }
}

// 让commonTest的依赖继承自testImplementation，复用基础测试依赖
val commonTestImplementation by configurations.getting {
    extendsFrom(configurations.testImplementation.get())
}
val commonTestRuntimeOnly by configurations.getting {
    extendsFrom(configurations.testRuntimeOnly.get())
}

configure<TestingExtension> {
    suites {
        val commonTestSourceSet = sourceSets.named("commonTest").get()
        
        // 配置单元测试套件
        val test by getting(JvmTestSuite::class) {
            testType.set(TestSuiteType.UNIT_TEST)
            sources {
                java.srcDir("src/test/unit/kotlin")
                resources.srcDir("src/test/unit/resources")
            }
            // 关联commonTest的编译产物与依赖
            dependencies {
                implementation(commonTestSourceSet.output)
                implementation(configurations.commonTestImplementation.get())
                runtimeOnly(configurations.commonTestRuntimeOnly.get())
            }
        }

        // 配置功能测试套件
        val functionalTest by registering(JvmTestSuite::class) {
            testType.set(TestSuiteType.FUNCTIONAL_TEST)
            sources {
                java.srcDir("src/test/functional/kotlin")
                resources.srcDir("src/test/functional/resources")
            }
            dependencies {
                implementation(project())
                // 复用commonTest的产物与依赖
                implementation(commonTestSourceSet.output)
                implementation(configurations.commonTestImplementation.get())
                runtimeOnly(configurations.commonTestRuntimeOnly.get())
            }
            targets {
                all {
                    testTask.configure {
                        shouldRunAfter(test)
                    }
                }
            }
        }

        // 同理配置集成测试套件
        val integrationTest by registering(JvmTestSuite::class) {
            testType.set(TestSuiteType.INTEGRATION_TEST)
            sources {
                java.srcDir("src/test/integration/kotlin")
                resources.srcDir("src/test/integration/resources")
            }
            dependencies {
                implementation(project())
                implementation(commonTestSourceSet.output)
                implementation(configurations.commonTestImplementation.get())
                runtimeOnly(configurations.commonTestRuntimeOnly.get())
            }
        }

        // 同理配置性能测试套件
        val performanceTest by registering(JvmTestSuite::class) {
            testType.set(TestSuiteType.PERFORMANCE_TEST)
            sources {
                java.srcDir("src/test/performance/kotlin")
                resources.srcDir("src/test/performance/resources")
            }
            dependencies {
                implementation(project())
                implementation(commonTestSourceSet.output)
                implementation(configurations.commonTestImplementation.get())
                runtimeOnly(configurations.commonTestRuntimeOnly.get())
            }
        }
    }
}

// 让其他测试套件的依赖配置继承自testImplementation（按需调整）
val functionalTestImplementation by configurations.getting {
    extendsFrom(configurations.testImplementation.get())
}
val integrationTestImplementation by configurations.getting {
    extendsFrom(configurations.testImplementation.get())
}
val performanceTestImplementation by configurations.getting {
    extendsFrom(configurations.testImplementation.get())
}

关键改进点 #

• 复用已编译产物：通过implementation(commonTestSourceSet.output)让各测试套件直接使用通用测试代码的编译结果，避免重复编译
• 依赖层级清晰：让commonTestImplementation继承testImplementation，同时让各测试套件依赖commonTest的配置，实现依赖复用
• 源集职责明确：每个测试套件仅管理自身专属源码，通用代码完全由commonTest源集维护

验证方法 #

运行任意测试任务（如./gradlew test或./gradlew functionalTest），检查测试代码是否能正常导入commonTest中的类和资源。

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