Kotest无法仅运行指定标签测试问题求助

1. 确认Kotest Maven插件配置是否正确 #

必须在pom.xml的<build>节点下配置Kotest专属Maven插件，否则命令行的-Dkotest.tags参数无法被识别。示例配置如下：

<plugin>
    <groupId>io.kotest</groupId>
    <artifactId>kotest-maven-plugin</artifactId>
    <version>5.3.0</version>
    <executions>
        <execution>
            <id>test</id>
            <goals>
                <goal>test</goal>
            </goals>
        </execution>
    </executions>
</plugin>

同时检查是否存在Spring Boot默认的surefire插件冲突，可通过配置surefire排除Kotlin测试类，确保测试执行权交给Kotest插件。

2. 验证测试类的标签注解是否正确 #

Kotest不兼容JUnit的@Tags注解，必须使用Kotest自带的io.kotest.core.annotation.Tag注解。正确写法示例：

import io.kotest.core.annotation.Tag
import io.kotest.core.spec.style.StringSpec

@Tag("CustomTest")
class MyBizTest : StringSpec({
    "test user login" {
        // 测试逻辑
    }
})

3. 检查命令行参数的准确性 #

确认参数拼写为-Dkotest.tags，标签名称与注解完全一致（区分大小写）。比如注解是@Tag("CustomTest")，参数不能写成customtest。仅运行指定标签的命令格式无误：

./mvnw test -Dkotest.tags="CustomTest"

4. 统一Kotest依赖版本 #

确保pom.xml中所有Kotest相关依赖（如kotest-runner-junit5-jvm、kotest-assertions-core）的版本均为5.3.0，版本不一致会导致兼容性问题。示例依赖配置：

<dependency>
    <groupId>io.kotest</groupId>
    <artifactId>kotest-runner-junit5-jvm</artifactId>
    <version>5.3.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.kotest</groupId>
    <artifactId>kotest-assertions-core-jvm</artifactId>
    <version>5.3.0</version>
    <scope>test</scope>
</dependency>

5. 排查全局配置覆盖问题 #

检查项目中是否存在kotest.properties文件，或代码中通过ProjectConfig设置了标签筛选规则，这些全局配置会优先于命令行参数生效。比如配置文件若写有kotest.tags=AllTests，则命令行参数会被忽略。

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