使用Gradle JVMTestSuite插件配置单元与集成测试遇阻求助

1. 配置测试类过滤规则 #

默认情况下，Gradle的test任务会扫描所有符合测试类命名规则的文件（如*Test.java、*IT.java），需要为两个测试套件分别设置过滤规则，实现按命名区分测试类型：

testing {
    suites {
        test {
            useJUnitJupiter()
            // 排除所有以IT结尾的测试类，仅运行单元测试
            targets {
                all {
                    testTask.configure {
                        exclude '**/*IT.java'
                    }
                }
            }
        }

        integrationTest(JvmTestSuite) {
            testType.set(TestSuiteType.INTEGRATION_TEST)
            useJUnitJupiter() // 明确指定使用JUnit Jupiter，确保测试框架一致

            dependencies {
                implementation project()
                // 添加Spring测试依赖（Spring Boot项目必备）
                implementation 'org.springframework.boot:spring-boot-starter-test'
                // 排除JUnit Vintage避免版本冲突
                implementation('org.springframework.boot:spring-boot-starter-test') {
                    exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
                }
            }

            targets {
                all {
                    testTask.configure {
                        // 仅包含以IT结尾的测试类
                        include '**/*IT.java'
                        shouldRunAfter(test)
                    }
                }
            }
        }
    }
}

tasks.named('check') { 
    dependsOn(testing.suites.integrationTest)
}

2. 确保集成测试类正确初始化Spring上下文 #

在你的*IT.java集成测试类中，添加Spring Boot测试注解触发上下文初始化：

import org.springframework.boot.test.context.SpringBootTest;
import org.junit.jupiter.api.Test;

@SpringBootTest
public class SampleIT {
    @Test
    public void sampleIntegrationTest() {
        // 编写集成测试逻辑
    }
}

关键说明 #

• 给test任务添加exclude '**/*IT.java'，避免单元测试任务执行集成测试类；
• 给integrationTest任务添加include '**/*IT.java'，确保只执行集成测试类，同时必须显式声明useJUnitJupiter()，否则可能因测试框架不匹配导致测试未被识别；
• 集成测试依赖中必须包含spring-boot-starter-test，否则Spring上下文无法完成初始化；
• shouldRunAfter(test)保证集成测试在单元测试之后执行，符合常规测试流程。

验证命令 #

• 执行./gradlew test：仅运行所有*Test.java单元测试；
• 执行./gradlew integrationTest：仅运行所有*IT.java集成测试，Spring上下文正常初始化；
• 执行./gradlew check：依次运行单元测试和集成测试。

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