Cucumber Java：如何为多组Scenario Outline示例保存对应变量？

核心思路 #

Cucumber默认会先执行完第一个Scenario Outline的所有示例，再启动第二个，所以静态变量会被后续示例覆盖。要实现示例一对一匹配复用，核心是按示例的索引位置存储变量，在第二个Scenario Outline中根据当前执行的示例索引取出对应值。

具体实现步骤 #

1. 定义非静态的变量存储结构 #

在Step Definition类中，用List来按索引存储每个示例生成的specialVariable，避免用static（静态变量会在所有测试实例间共享，导致值被覆盖）：

// 每个测试实例独立维护的存储列表，不要加static
private List<String> specialVariables = new ArrayList<>();

2. 在第一个Scenario Outline中存储变量 #

生成specialVariable时，将其存入列表对应索引的位置。有两种方式获取示例索引：

方式一：通过Cucumber内置对象获取索引

如果你的Cucumber版本支持ScenarioOutlineScenario，可以直接从Scenario对象中提取示例索引：

import io.cucumber.java.Scenario;
import io.cucumber.core.api.ScenarioOutlineScenario;

public class StepDefinitions {
    private List<String> specialVariables = new ArrayList<>();

    @Given("生成并存储特殊变量")
    public void generateAndStoreSpecialVariable(Scenario scenario) {
        // 获取当前示例的索引（从0开始计数）
        int exampleIndex = ((ScenarioOutlineScenario) scenario).getExampleIndex();
        String specialVariable = printHelper.printTestWithDate();
        
        // 确保列表长度足够，避免索引越界
        while (specialVariables.size() <= exampleIndex) {
            specialVariables.add(null);
        }
        specialVariables.set(exampleIndex, specialVariable);
    }
}

方式二：手动在Examples中添加索引列（兼容性更强）

如果Cucumber版本不支持上述对象，直接在第一个Scenario Outline的Examples里加索引列，更稳妥：

Scenario Outline: 生成特殊变量
  Given 生成并存储索引为<index>的特殊变量
  Examples:
    | index | 其他测试参数 |
    | 0     | 参数A        |
    | 1     | 参数B        |

对应的步骤实现：

@Given("生成并存储索引为{int}的特殊变量")
public void generateAndStoreSpecialVariable(int index) {
    String specialVariable = printHelper.printTestWithDate();
    
    while (specialVariables.size() <= index) {
        specialVariables.add(null);
    }
    specialVariables.set(index, specialVariable);
}

3. 在第二个Scenario Outline中取出对应变量 #

执行第二个Scenario Outline时，用同样的方式获取当前示例索引，从列表中取出对应值：

// 方式一：通过内置对象取索引
@Given("使用之前生成的特殊变量")
public void useSpecialVariable(Scenario scenario) {
    int exampleIndex = ((ScenarioOutlineScenario) scenario).getExampleIndex();
    String targetVariable = specialVariables.get(exampleIndex);
    // 这里编写使用变量的业务逻辑，比如接口传参、断言等
    System.out.println("当前示例匹配的变量：" + targetVariable);
}

// 方式二：用手动添加的索引列
@Given("使用索引为{int}的特殊变量")
public void useSpecialVariable(int index) {
    String targetVariable = specialVariables.get(index);
    // 业务逻辑代码
}

对应的第二个Scenario Outline的Examples也要对应添加相同的索引列，保证一一匹配：

Scenario Outline: 使用特殊变量
  Given 使用索引为<index>的特殊变量
  Examples:
    | index | 测试参数 |
    | 0     | 参数X    |
    | 1     | 参数Y    |

注意事项 #

• 必须保证两个Scenario Outline的Examples数量一致，索引一一对应，否则会出现索引越界或匹配错误。
• 如果是并行测试场景，需要给每个线程单独维护存储列表（可以用ThreadLocal<List<String>>替代普通List），避免线程间变量干扰。

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