如何在Gradle+Spring Boot+Kotlin项目中拆分单元/集成/E2E测试目录

实现方案 #

1. 配置Gradle多测试源集搭建目标目录结构 #

使用Gradle 7+内置的jvm-test-suite插件实现多测试目录隔离，修改build.gradle.kts配置如下：

plugins {
    id("org.springframework.boot") version "2.4.6"
    id("io.spring.dependency-management") version "1.0.11.RELEASE"
    kotlin("jvm") version "1.5.0"
    kotlin("plugin.spring") version "1.5.0"
    `jvm-test-suite`
}

// 其他基础配置省略...

testing {
    suites {
        // 单元测试配置（对应src/test目录）
        val test by getting(JvmTestSuite::class) {
            useJUnitJupiter()
            dependencies {
                implementation(project)
                // 补充单元测试需要的MockK、Mockito等依赖
            }
            targets.all {
                testTask.configure {
                    // 单元测试默认激活test profile
                    systemProperty("spring.profiles.active", "test")
                }
            }
        }

        // 集成测试配置（对应src/integration目录）
        val integrationTest by registering(JvmTestSuite::class) {
            dependencies {
                implementation(project)
                implementation(test) // 复用单元测试依赖
                // 补充集成测试需要的TestContainers等依赖
            }
            targets.all {
                testTask.configure {
                    shouldRunAfter(test) // 集成测试在单元测试后执行
                    // 集成测试默认激活integration profile
                    systemProperty("spring.profiles.active", "integration")
                }
            }
        }

        // E2E测试配置（对应src/e2e目录）
        val e2eTest by registering(JvmTestSuite::class) {
            dependencies {
                implementation(project)
                implementation(integrationTest)
            }
            targets.all {
                testTask.configure {
                    shouldRunAfter(integrationTest)
                    systemProperty("spring.profiles.active", "e2e")
                }
            }
        }
    }
}

// 按需配置：执行check命令时同时运行集成测试
tasks.named("check") {
    dependsOn(testing.suites.named("integrationTest"))
}

配置完成后在src目录下手动创建integration/kotlin、integration/resources、e2e/kotlin、e2e/resources目录即可完成结构搭建。

2. 多Profile配置解决外部依赖连接问题 #

你之前Kafka排除配置未生效的原因有两个：一是YAML语法错误（spring后缺冒号、缩进错误），二是仅排除了Kafka核心自动配置，没有排除重试主题的自动配置类。按以下方式配置即可：

单元测试配置（路径：src/test/resources/application-test.yml）

完全禁用Kafka、数据库的自动配置，不会发起外部连接：

spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.kafka.KafkaAutoConfiguration
      - org.springframework.kafka.annotation.RetryableTopicAutoConfiguration
      - org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
      - org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration
  main:
    allow-bean-definition-overriding: true

集成测试配置（路径：src/integration/resources/application-integration.yml）

保留正常的Kafka、PostgreSQL配置，不需要排除自动配置，直接复用你现有生产配置的Kafka、数据源、JPA参数即可。

3. 单元测试全局自动Mock Kafka组件 #

不需要在每个测试类加@MockKafka注解，通过全局测试配置实现自动注入Mock：

1. 新增单元测试全局配置类（路径：src/test/kotlin/你的包路径/test/TestMockConfig.kt）

@TestConfiguration
class TestMockConfig {
    @MockBean
    lateinit var myConsumer: MyConsumer

    @MockBean
    lateinit var myProducer: MyProducer
}

2. 新增Spring自动配置注册文件（路径：src/test/resources/META-INF/spring.factories）

org.springframework.boot.test.autoconfigure.OverrideAutoConfiguration=你的包路径.test.TestMockConfig

配置完成后所有单元测试的Spring上下文会自动加载该配置，全局替换Kafka相关Bean为Mock对象，无需额外加注解。

如果是不需要启动Spring上下文的纯业务单元测试，直接手动传入Mock的依赖初始化测试类即可，性能更高且完全不会触发外部连接逻辑。

4. 测试执行命令 #

• 运行单元测试：./gradlew test
• 运行集成测试：./gradlew integrationTest
• 运行E2E测试：./gradlew e2eTest

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