无法通过命令行指定标签运行Serenity Cucumber测试

问题根源 #

你使用的Serenity 4.x版本集成的是Cucumber 7.x，而--tags是Cucumber 6及更早版本的参数，Cucumber 7+已将标签过滤参数改为--filter-tags，这就是报错Unrecognized option: --tags=@UI的核心原因。

可行解决方案 #

1. 使用Cucumber 7+的正确参数 #

直接替换命令中的参数为--filter-tags，执行以下命令：

mvn verify -Dcucumber.options="--filter-tags @UI"

如果仍提示构建失败，添加-X参数查看详细日志，确认是否存在无匹配标签的测试用例，或测试用例本身存在错误。

2. 采用Serenity内置的标签参数 #

Serenity提供了更简洁的tags系统属性，无需依赖Cucumber的参数格式，命令如下：

mvn verify -Dtags="@UI"

该方式可与你POM中已定义的<tags>占位符联动，更贴合Serenity的生态使用习惯。

3. 优化POM配置（关键） #

你的POM存在几处可能导致兼容性问题的配置，建议调整：

• 统一Failsafe插件版本：当前插件使用的3.0.0-M5版本较旧，替换为你已定义的${maven.failsafe.plugin.version}（3.1.2）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>${maven.failsafe.plugin.version}</version>
    <!-- 其他原有配置保留 -->
</plugin>

• 传递参数到测试进程：在Failsafe插件的<configuration>中添加以下配置，确保命令行传入的参数能被测试进程读取：

<configuration>
    <testFailureIgnore>true</testFailureIgnore>
    <forkCount>${parallel.tests}</forkCount>
    <reuseForks>true</reuseForks>
    <includes>**/TestRunner*.java</includes>
    <!-- 新增：传递系统参数 -->
    <systemPropertyVariables>
        <tags>${tags}</tags>
        <cucumber.options>${cucumber.options}</cucumber.options>
    </systemPropertyVariables>
</configuration>

• 对齐Serenity Cucumber版本：你POM中定义的${serenity.cucumber.version}为2.6.0，属于旧版本，与Serenity 4.x不兼容，建议修改为与核心版本一致：

<!-- 先更新properties中的版本 -->
<serenity.cucumber.version>4.0.29</serenity.cucumber.version>

<!-- 再更新依赖版本 -->
<dependency>
    <groupId>net.serenity-bdd</groupId>
    <artifactId>serenity-cucumber</artifactId>
    <version>${serenity.cucumber.version}</version>
</dependency>

验证步骤 #

1. 执行mvn clean清理构建缓存
2. 用方案2的命令测试：mvn verify -Dtags="@UI"
3. 若仍失败，执行mvn verify -Dtags="@UI" -X查看详细日志，定位具体问题（如无匹配标签的用例、测试代码报错等）

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