如何在运行Karate前检查所有场景是否包含指定标签？

方法1：利用Karate的FeatureParser提前解析特征文件 #

Karate内置的FeatureParser类可以在测试启动前手动加载并解析所有特征文件，遍历每个场景完成标签校验。

示例代码：

import com.intuit.karate.Feature;
import com.intuit.karate.FeatureParser;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.List;

public class PreExecutionTagChecker {
    public static void checkAllScenariosHaveTag(String featureDir, String requiredTag) {
        try {
            Files.walk(Paths.get(featureDir))
                 .filter(Files::isRegularFile)
                 .filter(path -> path.toString().endsWith(".feature"))
                 .forEach(path -> {
                     Feature feature = FeatureParser.parse(path.toFile());
                     feature.getScenarios().forEach(scenario -> {
                         List<String> tags = scenario.getTags();
                         if (!tags.contains(requiredTag)) {
                             throw new RuntimeException("场景 '" + scenario.getName() + "' 在文件 " + path + " 中缺少必填标签: " + requiredTag);
                         }
                     });
                 });
        } catch (Exception e) {
            throw new RuntimeException("前置标签检查失败", e);
        }
    }

    // 在测试启动前调用该方法
    public static void main(String[] args) {
        checkAllScenariosHaveTag("src/test/resources/features", "@required-tag");
        // 完成检查后再启动Karate测试
        // Runner.path("classpath:features").parallel(5);
    }
}

方法2：结合测试框架的前置钩子执行检查 #

如果使用JUnit 5或TestNG，可以在测试套件的全局前置方法中执行标签检查，确保所有场景符合要求后再启动测试。

JUnit 5示例：

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import com.intuit.karate.junit5.Karate;

public class TestSuite {

    @BeforeAll
    static void preCheckTags() {
        PreExecutionTagChecker.checkAllScenariosHaveTag("src/test/resources/features", "@required-tag");
    }

    @Test
    Karate runAllTests() {
        return Karate.run().relativeTo(getClass());
    }
}

核心说明 #

• 上述方式完全在测试执行前完成校验，一旦发现缺少指定标签的场景，直接抛出异常终止测试启动，不会执行任何测试步骤。
• 可根据项目结构调整featureDir的路径，也可以扩展标签匹配逻辑，比如检查标签是否包含指定前缀：tags.stream().anyMatch(tag -> tag.startsWith("@prefix-"))。

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