如何为Spek测试使用JUnit5 @Tag注解区分单元与集成测试

我明白你遇到的问题了——JUnit 5的@Tag注解在Spek测试里没法正常生效，导致你没法按预期区分单元测试和集成测试。别担心，Spek有自己的标签机制，只需要调整一下代码和配置就能解决。

问题根源 #

Spek框架有一套自己的注解体系，它不会识别JUnit 5的org.junit.jupiter.api.Tag注解。要在Spek测试中使用标签，你需要用Spek专门提供的标签工具。

解决方案 #

1. 改用Spek的标签实现

首先，把测试类中的@Tag替换为Spek版本的注解，同时调整测试代码为Spek标准的DSL风格（如果之前是混用JUnit写法的话）：

// 导入Spek的Tag注解和核心类
import org.spekframework.spek2.annotation.Tag
import org.spekframework.spek2.Spek
import org.spekframework.spek2.style.specification.describe
import org.junit.jupiter.api.Assertions.assertEquals

@Tag("unit") // 使用Spek的Tag注解标记测试类
object MyObjectTest : Spek({
    describe("MyObject") {
        it("should be equal to itself") {
            val o1 = MyObject(1)
            assertEquals(o1, o1)
        }
    }
})

如果你更倾向于在测试DSL内部定义标签，而不是在类上，也可以这样写：

import org.spekframework.spek2.Spek
import org.spekframework.spek2.style.specification.describe
import org.junit.jupiter.api.Assertions.assertEquals

object MyObjectTest : Spek({
    tag("unit") // 在DSL中直接添加标签
    describe("MyObject") {
        it("should be equal to itself") {
            val o1 = MyObject(1)
            assertEquals(o1, o1)
        }
    }
})

2. 保持build.gradle配置不变（或微调）

Spek会自动将自己的标签映射为JUnit Platform能识别的标签，所以你之前的utest任务配置不需要大改，只要确保includeTags能过滤到目标标签就行：

task utest(type: Test) {
    outputs.upToDateWhen { false }
    useJUnitPlatform {
        includeTags 'unit' // 只执行标记为unit的测试
        // 如果需要排除集成测试，可以添加 excludeTags 'integration'
    }
}

额外提示 #

如果你的项目同时存在JUnit风格和Spek风格的测试，完全不用担心兼容性——JUnit的@Tag和Spek的标签都会被JUnit Platform正确识别，你的utest任务可以统一过滤两种测试的标签。

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