Maven与Cucumber测试：高级标签过滤与并行执行策略

本文旨在解决maven surefire插件在运行cucumber测试时，`cucumber.filter.tags`参数未正确生效以及如何实现"and"逻辑过滤的问题。文章将详细阐述cucumber标签表达式的用法，提供正确的maven surefire插件配置示例，并指导如何通过命令行精确控制测试执行，同时探讨并行测试的配置方法，以优化测试效率和管理。

引言：Cucumber标签过滤与测试管理

在行为驱动开发（BDD）实践中，Cucumber框架通过标签（Tags）机制提供了灵活的测试用例组织和执行控制能力。开发者可以为不同的Feature或Scenario添加标签，例如@smoke、@regression、@WIP（Work In Progress）或特定功能模块如@Account、@OCR。这种机制使得测试团队能够根据需要选择性地运行测试，例如只运行冒烟测试、只运行特定功能模块的测试，或排除仍在开发中的测试。

然而，在使用Maven管理Cucumber项目时，经常会遇到通过命令行参数（如-Dcucumber.filter.tags）进行标签过滤不生效，或者无法实现复杂的标签逻辑（如"AND"、"OR"）的问题。同时，为了提高测试执行效率，配置并行测试也是一个常见的需求。本教程将深入探讨这些问题，并提供一套行之有效的解决方案。

理解Cucumber标签表达式

现代Cucumber版本（例如7.x及以上）支持强大的标签表达式，允许用户组合使用and (&&)、or (||) 和 not (!) 逻辑操作符来构建复杂的过滤条件。

• @tag1: 匹配包含@tag1的Scenario。
• @tag1 or @tag2 / @tag1, @tag2: 匹配包含@tag1或@tag2的Scenario。逗号通常被解析为OR。
• @tag1 and @tag2: 匹配同时包含@tag1和@tag2的Scenario。
• not @tag1: 匹配不包含@tag1的Scenario。
• (@tag1 or @tag2) and not @tag3: 匹配包含@tag1或@tag2，但不包含@tag3的Scenario。

正确理解这些表达式是实现精确过滤的基础。

天工大模型

中国首个对标ChatGPT的双千亿级大语言模型

下载

Maven Surefire插件配置：正确传递Cucumber参数

maven-surefire-plugin是Maven中用于运行单元和集成测试的核心插件。要使Cucumber的标签过滤功能生效，关键在于正确配置Surefire插件，确保cucumber.filter.tags系统属性能够被Cucumber运行时正确读取。

问题分析：cucumber.filter.tags未生效的常见原因

1. Surefire插件版本过旧：旧版本的Surefire可能对系统属性的传递方式或与最新Cucumber版本的兼容性存在问题。
2. 系统属性传递方式不当：直接在mvn命令中使用-Dtags或-D"cucumber.filter.tags"有时可能无法被Surefire正确解析并传递给测试JVM。
3. TestRunner中的@CucumberOptions冲突：如果在TestRunner类中的@CucumberOptions注解中也设置了tags属性，它可能会覆盖或与命令行参数产生冲突。

推荐的Surefire插件配置

为了解决上述问题，建议采取以下配置策略：

1. 升级Surefire插件版本：推荐使用Surefire 3.0.0-M5或更高版本，以获得更好的兼容性和功能支持。
2. 通过<systemPropertyVariables>传递参数：这是最推荐的方式，它允许Surefire将Maven命令行中定义的属性（如-Dcucumber.filter.tags）作为系统属性传递给测试JVM。
3. 配置并行执行：Surefire插件提供了灵活的并行执行选项，可以显著缩短测试运行时间。

以下是基于原始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>
        <aspectj.version>1.8.10</aspectj.version>
        <!-- project.build.directory 通常指向 target 目录，此处保持原样但需注意其含义 -->
        <project.build.directory>${project.basedir}/target</project.build.directory>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <!-- 定义Surefire插件版本 -->
        <maven-surefire-plugin.version>3.0.0-M7</maven-surefire-plugin.version>
        <!-- 定义Cucumber版本 -->
        <cucumber.version>7.5.0</cucumber.version>
        <!-- 定义JUnit 4版本，与Cucumber-JUnit 兼容 -->
        <junit.version>4.13.2</junit.version>
    </properties>

    <dependencies>
        <!-- REST Assured -->
        <dependency>
            <groupId>io.rest-assured</groupId>
            <artifactId>rest-assured</artifactId>
            <version>4.4.0</version>
        </dependency>

        <!-- JUnit 4 - 与 Cucumber-JUnit 兼容 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>

        <!-- Cucumber Java -->
        <dependency>
            <groupId>io.cucumber</groupId>
            <artifactId>cucumber-java</artifactId>
            <version>${cucumber.version}</version>
            <scope>test</scope>
        </dependency>

        <!-- Cucumber JUnit Runner -->
        <dependency>
            <groupId>io.cucumber</groupId>
            <artifactId>cucumber-junit</artifactId>
            <version>${cucumber.version}</version>
            <scope>test</scope>
        </dependency>

        <!-- 其他依赖保持不变，但需注意JUnit Jupiter与JUnit 4的混用 -->
        <!-- 原pom中包含JUnit Jupiter依赖，如果TestRunner使用@RunWith(Cucumber.class)则应移除JUnit Jupiter相关依赖，
             或切换为Cucumber JUnit Platform Engine来支持JUnit 5。
             此处为保持与TestRunner一致性，假定使用JUnit 4。 -->
        <dependency>
            <groupId>com.oracle.database.jdbc</groupId>
            <artifactId>ojdbc8</artifactId>
            <version>19.17.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-chrome-driver</artifactId>
            <version>4.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>4.0.0-rc-2</version>
        </dependency>
        <dependency>
            <groupId>org.hamcrest</groupId>
            <artifactId>hamcrest</artifactId>
            <version>2.2</version>
        </dependency>
        <dependency>