Gradle集成测试报错：package org.junit.jupiter.api不存在

你遇到的package org.junit.jupiter.api does not exist错误，核心是自定义的integrationTest源集没有正确获取到JUnit 5的依赖，加上多项目结构下的配置作用域问题，导致编译时找不到相关类。以下是具体问题和修复步骤：

1. 自定义源集未配置专属依赖 #

默认情况下，testImplementation依赖只作用于Gradle自带的test源集，你自定义的integrationTest源集不会自动继承这些依赖。需要为它单独声明JUnit依赖：

dependencies {
    // 原有测试依赖保留
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'
    
    // 给集成测试源集添加专属依赖
    integrationTestImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
    integrationTestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'
}

2. 多项目结构下配置作用域错误 #

你的sourceSets和integrationTest任务是在根项目下声明的，但实际的测试代码应该在子项目中。需要把这些配置移到subprojects块内，确保每个子项目都能应用这些配置：

subprojects {
    // 原有子项目配置...
    
    sourceSets {
        integrationTest {
            java {
                compileClasspath += main.output + test.output
                runtimeClasspath += main.output + test.output
                // 建议使用独立目录避免和默认test源集冲突，比如：
                srcDir file('src/integrationTest/java')
            }
        }
    }

    dependencies {
        testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
        testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'
        integrationTestImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
        integrationTestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'
    }

    task integrationTest(type: Test) {
        useJUnitPlatform()
        testClassesDirs = sourceSets.integrationTest.output.classesDirs
        classpath = sourceSets.integrationTest.runtimeClasspath
    }
}

3. 源集路径冲突（可选优化） #

你当前把integrationTest的源码目录设为test/，这和默认test源集的路径重叠，可能导致编译时混淆。建议改为独立目录（比如src/integrationTest/java），保持测试代码的清晰分离。

额外验证步骤 #

• 执行./gradlew clean integrationTest，先清理旧的编译产物再运行测试
• 检查子项目中集成测试类的位置是否和你配置的srcDir一致
• 运行./gradlew dependencies --configuration integrationTestCompileClasspath，确认JUnit 5依赖是否出现在集成测试的编译类路径中

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