本文介绍如何在 Cucumber + Spring Boot（Java）项目中，使用同一组 Scenario Outline 实现跨多站点（如 hotels.com、cars.com）的测试数据隔离与复用，核心方案是结合 @tag 与 --tags 运行参数动态加载对应 Examples 数据块。
本文介绍如何在 cucumber + spring boot（java）项目中，使用同一组 scenario outline 实现跨多站点（如 hotels.com、cars.com）的测试数据隔离与复用，核心方案是结合 `@tag` 与 `--tags` 运行参数动态加载对应 examples 数据块。
在 Cucumber 中，Scenario Outline 的 Examples 表格默认全局生效，但实际项目中常需为不同环境或目标站点（如 hotels.com 和 cars.com）提供专属测试数据——而无需复制整个场景。Cucumber 原生支持通过 标签（Tags）绑定 Examples 块，实现数据级的条件化加载。
✅ 正确写法如下（单个 .feature 文件内组织）：
Feature: Search
@smoke @search
Scenario Outline: I want to search for products
Given I enter "<keyword>" as a keyword to a search field
Then I should see search results page
Then I should see at least <count> results containing "<keyword>"
@hotels
Examples:
| keyword | count |
| hotel | 3 |
@cars
Examples:
| keyword | count |
| cars | 3 |? 关键点说明：
- 每个 Examples 表上方添加独立标签（如 @hotels、@cars），标签必须顶格、紧邻 Examples 行上方，且不能缩进；
- 标签作用于该 Examples 表，而非整个 Scenario Outline；
- 执行时通过 Cucumber 运行参数指定标签，即可只加载匹配的数据块。例如：
- 运行酒店站测试：mvn test -Dcucumber.filter.tags="@hotels"
- 运行汽车站测试：mvn test -Dcucumber.filter.tags="@cars"
? 在 Spring Boot + Java 环境中，确保 cucumber-junit-platform-engine 或 cucumber-java 依赖版本 ≥ 7.0（推荐 7.14+），以完整支持 tagged Examples 语法（该特性自 Cucumber JVM 6.10+ 正式引入，7.x 全面稳定）。
⚠️ 注意事项：
- 不要将多个 @tag 写在同一行（如 @hotels @cars），否则该 Examples 会被两个标签同时触发；
- 若未指定 --tags 参数，Cucumber 默认执行所有 Examples（含所有标签块），可能导致数据冲突或断言失败，请务必在 CI/CD 或本地调试中显式传参；
- 示例字段名（keyword, count）必须在所有 Examples 表中保持完全一致，否则解析报错；
- 如需更灵活的数据管理（如读取 YAML/JSON 外部配置），可结合 Cucumber 的 DataTable 或自定义 ParameterType 扩展，但标签方案已满足绝大多数多站点复用场景。
通过此方式，你只需维护一份业务逻辑清晰的 Scenario Outline，即可安全、可追溯地支撑多站点自动化回归，大幅提升测试资产复用率与可维护性。
