Cucumber+JUnit5并行执行时每个场景的TestContext线程安全方案咨询

先明确核心结论：Cucumber的每个场景在并行执行时，从@Before钩子到场景执行再到@After钩子的整个生命周期，都会在同一个线程内完成，所以你设想的ThreadLocal方案是完全安全的，不用担心中途切换线程导致的问题。

下面给你梳理几种可行方案，按推荐优先级排序：

1. 最优解：利用Cucumber-Spring的@ScenarioScope #

如果你用的是cucumber-spring，直接给你的TestContext Bean加上@ScenarioScope注解，Spring会自动为每个Cucumber场景创建一个独立的TestContext实例，完全不需要手动处理线程隔离：

@Component
@ScenarioScope
public class TestContext {
    // 你的上下文属性和方法
}

这样每个场景拿到的都是自己专属的TestContext，单例Bean的线程安全问题直接解决，代码最简洁，也不需要在@Before里手动重置状态——每个场景都会拿到全新的实例。

2. 简洁方案：ThreadLocal存储TestContext #

如果因为某些原因不能用@ScenarioScope，ThreadLocal是最直接的选择。因为场景全程单线程执行，ThreadLocal不会出现线程污染：

@Component
public class TestContext {
    private final ThreadLocal<Map<String, Object>> context = new ThreadLocal<>();

    @Before
    public void resetContext(Scenario scenario) {
        // 每个场景开始时初始化线程本地的上下文
        context.set(new HashMap<>());
        // 如果需要存Scenario实例也可以
        // context.get().put("scenario", scenario);
    }

    @After
    public void clearContext() {
        // 场景结束后清理，避免内存泄漏
        context.remove();
    }

    // 提供获取/设置属性的方法
    public void setAttribute(String key, Object value) {
        context.get().put(key, value);
    }

    public Object getAttribute(String key) {
        return context.get().get(key);
    }
}

这里注意在@After里调用remove()，防止ThreadLocal因为线程池复用导致的内存泄漏问题。

3. 备选方案：ConcurrentHashMap + ScenarioId #

这个方案也能工作，但没必要——因为ThreadLocal已经帮你做了线程隔离，用Map还要额外处理并发（必须用ConcurrentHashMap），代码更繁琐：

@Component
public class TestContext {
    private final ConcurrentHashMap<String, Map<String, Object>> scenarioContexts = new ConcurrentHashMap<>();

    @Before
    public void initContext(Scenario scenario) {
        scenarioContexts.put(scenario.getId(), new HashMap<>());
    }

    @After
    public void cleanupContext(Scenario scenario) {
        scenarioContexts.remove(scenario.getId());
    }

    public void setAttribute(Scenario scenario, String key, Object value) {
        scenarioContexts.get(scenario.getId()).put(key, value);
    }
}

这种方案需要每次操作都传递Scenario实例或者ScenarioId，不如ThreadLocal方便，除非你有跨线程共享场景上下文的特殊需求（但并行场景下一般不需要）。

关于获取当前Scenario的其他方式 #

除了在@Before/@After钩子中直接注入Scenario参数外，你还可以：

• 在步骤定义方法中直接注入Scenario：

@Given("用户登录系统")
public void userLogin(Scenario scenario) {
    // 直接使用scenario实例
    scenario.log("开始执行登录步骤");
}

• 结合ThreadLocal存储Scenario，在需要的地方直接获取，不用每次注入：
  比如在TestContext里维护一个ThreadLocal，在@Before中设置，之后任何需要的地方都可以从TestContext里拿到当前场景实例。

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