本文详解如何在 Serenity BDD 中通过 Maven 命令行灵活组合标签（如 OR/AND 逻辑），实现跨类别的精准测试筛选，避免误执行无关用例。
本文详解如何在 serenity bdd 中通过 maven 命令行灵活组合标签（如 `or`/`and` 逻辑），实现跨类别的精准测试筛选，避免误执行无关用例。
在 Serenity BDD 中，标签（Tags）是组织和筛选测试用例的核心机制。如您所示，不同测试类被赋予了不同组合的标签（例如 @myTag1、@myTag2、@myTag3），而目标是仅运行同时带有 @myTag1 或 @myTag2 的测试（即 Class1 和 Class2），排除 @myTag3（Class3）——这本质上是一个逻辑“或”（OR）筛选需求。
Serenity 支持基于 JUnit 或 Cucumber 的标签过滤，其 Maven 属性语法与标准 JUnit 不同，需使用 -Dtags= 配合布尔表达式。正确命令如下：
mvn clean verify -Dtags="@myTag1 or @myTag2"
✅ 关键说明：
使用 verify（而非 install）更符合测试执行惯例（install 会触发部署阶段，非必要）；
标签名前必须加 @ 符号（如 @myTag1），否则 Serenity 将无法识别；
-
or 是大小写不敏感的关键字，也支持 AND、NOT 构成复杂表达式，例如：
# 运行含 myTag1 且不含 myTag3 的测试 mvn verify -Dtags="@myTag1 and not @myTag3" # 运行同时含两个标签的测试（交集） mvn verify -Dtags="@myTag and @smoke"
⚠️ 注意事项：
- Serenity 5.x+ 默认启用 serenity-junit5 或 serenity-cucumber 时，-Dtags 即为标准入口；若使用旧版或混合框架，可尝试备用属性：
# Cucumber 场景专用（当使用 .feature 文件时） mvn verify -Dtags.filter.cucumber="@myTag1 or @myTag2"
- 确保 serenity-maven-plugin 已正确配置（推荐版本 ≥ 3.8.0），并在 pom.xml 中启用标签解析：
<plugin> <groupId>net.serenity-bdd.maven.plugins</groupId> <artifactId>serenity-maven-plugin</artifactId> <version>${serenity.version}</version> <configuration> <tags>${tags}</tags> <!-- 支持命令行传参 --> </configuration> </plugin> - 标签表达式*不支持通配符（如 `@myTag`）或正则匹配**，需显式列出；多个标签间无空格要求，但建议保留空格提升可读性。
? 验证技巧：
执行命令后，观察控制台输出中的 Running tests matching tags: 行，确认解析结果是否符合预期。也可添加 -X 参数启用 Maven 调试日志，检查 serenity-maven-plugin 是否成功注入 tags 参数。
综上，要精准运行 Class1（@myTag1）和 Class2（@myTag2）而不触发 Class3（@myTag3），唯一可靠的方式就是使用布尔标签表达式：mvn clean verify -Dtags="@myTag1 or @myTag2"。这是 Serenity 内置的轻量级筛选能力，无需修改代码、不依赖 IDE，适合 CI/CD 流水线自动化调度。
