本文详细探讨了在使用maven surefire插件运行cucumber测试时，如何有效地进行标签过滤，避免所有测试场景被执行的问题。文章将深入解析命令行参数、`@cucumberoptions`配置的正确用法，以及处理`and`/`or`逻辑的策略，旨在帮助开发者精确控制测试的执行范围。
理解Cucumber标签过滤机制
在自动化测试中，特别是使用Cucumber框架时，标签（Tags）是一种强大的组织和过滤测试场景的方式。通过为Feature文件中的Scenario或Scenario Outline添加@tagname，我们可以根据需要选择性地运行特定类别的测试。当结合Maven构建工具和Surefire插件执行测试时，正确配置标签过滤至关重要。
maven-surefire-plugin负责执行单元和集成测试。对于Cucumber测试，Surefire插件通常会运行一个或多个TestRunner类，而真正的标签过滤逻辑则由Cucumber框架自身处理。
常见的标签过滤误区
许多开发者在尝试通过Maven命令行过滤Cucumber标签时，可能会遇到所有测试都被执行的问题。这通常是由于以下原因：
- 不正确的系统属性名称： 混淆JUnit的tags属性与Cucumber特有的cucumber.filter.tags属性。
- AND操作符的兼容性或解析问题： 在某些Cucumber版本或特定的命令行环境下，直接在cucumber.filter.tags中使用and操作符可能会导致解析失败或行为异常。例如，尝试mvn test -D"cucumber.filter.tags=@Account and @OCR" 可能无法按预期工作。
- OR操作符的语法： 对于多个标签的OR逻辑，错误的语法也会导致过滤失败。
有效的Cucumber标签过滤策略
要精确控制Cucumber测试的执行，可以采用以下两种主要策略：
策略一：通过命令行参数进行过滤
使用cucumber.filter.tags系统属性是动态过滤测试的推荐方法。这种方式允许在不修改代码的情况下，根据每次运行的需求指定不同的标签。
1. 使用OR逻辑过滤： 如果希望运行标记为@Account或@OCR的任何场景，可以使用or操作符。这在大多数Cucumber版本中都非常稳定且推荐。
mvn clean test -D"cucumber.filter.tags=@Account or @OCR"
2. 使用AND逻辑过滤： 虽然Cucumber框架本身支持复杂的标签表达式，包括and操作符（例如，@tag1 and @tag2），但在通过命令行传递时，由于Shell解析、特定Cucumber版本或maven-surefire-plugin与Cucumber Runner的交互方式，可能会出现问题。
如果直接的and表达式不工作，可以考虑以下替代方案：
- 确保Cucumber版本支持： 检查您的io.cucumber:cucumber-junit和io.cucumber:cucumber-java版本，确保它们是较新的，通常较新版本对标签表达式的支持更好。
- 在TestRunner中定义： 如果命令行传递and遇到困难，将复杂的and逻辑定义在TestRunner中可能更稳定（详见策略二）。
策略二：在TestRunner中配置标签
在TestRunner.java文件中使用@CucumberOptions注解的tags属性是另一种常见的过滤方式。这种方法将标签过滤逻辑硬编码到测试运行器中，适用于需要固定运行特定标签集合的场景。
package cucumberOptions;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
import org.junit.runner.RunWith;
@RunWith(Cucumber.class)
@CucumberOptions(
features = "src/test/java/features",
glue = {"Steps","SQL"},
// 在这里配置标签过滤
tags = "@Account or @OCR" // 运行 @Account 或 @OCR 标签的场景
// tags = "@Account and @OCR" // 运行同时具有 @Account 和 @OCR 标签的场景
// tags = "not @Ignore" // 运行所有未标记 @Ignore 的场景
)
public class TestRunner {
}优先级说明： 通过命令行传递的cucumber.filter.tags系统属性通常会覆盖@CucumberOptions中定义的tags属性。这意味着，如果两者都存在，命令行参数将优先。
Maven pom.xml 配置
为了确保Maven Surefire插件能够正确执行Cucumber测试并传递系统属性，pom.xml文件中的配置至关重要。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>LifeboxAutomation</groupId>
<artifactId>LifeboxAutomation</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<!-- 定义Cucumber版本，方便管理 -->
<cucumber.version>7.5.0</cucumber.version>
<surefire.version>2.22.2</surefire.version>
</properties>
<dependencies>
<!-- Cucumber Dependencies -->
<dependency>
<groupId>io.cucumber</groupId>
<artifactId>cucumber-java</artifactId>
<version>${cucumber.version}</version>
</dependency>
<dependency>
<groupId>io.cucumber</groupId>
<artifactId>cucumber-junit</artifactId>
<version>${cucumber.version}</version>
<scope>test</scope>
</dependency>
<!-- JUnit 4 (因为TestRunner使用了@RunWith(Cucumber.class)，它依赖JUnit 4) -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- 其他依赖，如Rest Assured, Selenium等 -->
<!-- ... (保持原有pom.xml中的其他依赖) ... -->
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<includes>src/test/**/*.java</includes>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>${surefire.version}</version>
<configuration>
<encoding>UTF-8</encoding>
<argLine>-Dfile.encoding=${project.build.sourceEncoding}</argLine>
<!-- 如果需要并行执行，可以添加以下配置，但这与标签过滤是独立的概念 -->
<!-- <parallel>methods</parallel> -->
<!-- <threadCount>4</threadCount> -->
<!-- 确保Surefire能够找到并执行TestRunner -->
<test>**/*TestRunner.java</test>
</configuration>
</plugin>
</plugins>
</build>
</project>注意事项：
- Surefire版本： 确保使用最新稳定版的maven-surefire-plugin，以获得更好的兼容性和功能。
-
test配置：
**/*TestRunner.java 确保Surefire插件能够找到并执行你的Cucumber TestRunner类。 - 并行执行： parallel和threadCount配置用于控制测试的并行执行，这与标签过滤是正交的概念，它们不会影响标签过滤的逻辑，只影响被过滤后剩余测试的运行方式。
总结
在Maven项目中结合Cucumber进行标签过滤，关键在于理解Cucumber的标签表达式语法以及如何通过maven-surefire-plugin正确传递这些表达式。优先使用cucumber.filter.tags系统属性配合or逻辑进行命令行过滤，可以提供最大的灵活性。对于更复杂的或固定的过滤需求，在@CucumberOptions中直接定义tags也是一个可靠的选择。始终确保您的Cucumber依赖版本是最新的，以利用最新的功能和改进。
