Kotlin-Gradle多模块Spring项目共享测试依赖配置问题

问题根源 #

你使用了java-test-fixtures插件，但针对Kotlin项目，需要配合Kotlin插件调整配置；同时Gradle的testFixtures源码集默认指向src/testFixtures/kotlin，而非你当前的src/test/kotlin，导致其他模块无法识别TestUtil类。

修复步骤 #

1. 调整child_shared_module的build.gradle.kts配置 #

确保应用正确插件，并配置testFixtures源码集适配现有目录：

plugins {
    id("org.jetbrains.kotlin.jvm") version "1.9.22"
    id("java-library")
    id("java-test-fixtures")
    // 若为Spring Boot模块，添加以下插件（版本匹配你的项目）
    id("org.springframework.boot") version "3.2.0"
    id("io.spring.dependency-management") version "1.1.4"
}

// 配置testFixtures源码集包含现有test目录下的代码
sourceSets {
    val testFixtures by getting {
        kotlin.srcDir("src/test/kotlin")
        resources.srcDir("src/test/resources") // 若有共享测试资源也需配置
    }
}

// 可选：为testFixtures添加共享依赖（如Spring测试包）
dependencies {
    testFixturesApi("org.springframework.boot:spring-boot-starter-test")
    testFixturesImplementation(kotlin("test"))
}

tasks.withType<Test> {
    useJUnitPlatform()
}

2. （推荐）规范目录结构（可选但更符合Gradle约定） #

将child_shared_module下的src/test/kotlin/com/domain/testUtilities/TestUtil.kt移动到src/testFixtures/kotlin/com/domain/testUtilities/TestUtil.kt，无需额外配置源码集，直接遵循Gradle testFixtures默认约定。

3. 确认child_1和child_2模块的依赖配置 #

确保这两个模块正确引入依赖并应用Kotlin插件：

plugins {
    id("org.jetbrains.kotlin.jvm") version "1.9.22"
    id("org.springframework.boot") version "3.2.0"
    id("io.spring.dependency-management") version "1.1.4"
}

dependencies {
    // 业务依赖...
    testImplementation(testFixtures(project(":child_shared_module")))
    testImplementation("org.springframework.boot:spring-boot-starter-test")
    testImplementation(kotlin("test"))
}

tasks.withType<Test> {
    useJUnitPlatform()
}

4. 同步Gradle并验证 #

执行./gradlew clean build --refresh-dependencies刷新依赖，之后在child_1或child_2的测试类中导入com.domain.testUtilities.TestUtil，即可正常使用工具类。

常见排查点 #

• 检查包路径一致性：确保TestUtil的包名与其他模块测试类的导入语句完全匹配
• 确认Gradle同步完成：IDE可能需要手动触发Gradle项目同步
• 验证版本兼容性：Gradle 8.5与Kotlin 1.9.22、Spring Boot 3.x版本兼容，避免版本冲突

内容的提问来源于stack exchange，提问作者kokk.nik