Cucumber 7中替代ExtendedCucumber Runner实现注解覆写等需求的方案咨询

针对你在Cucumber 7.9.0中无法继承Cucumber类的问题，下面是对应原有功能的替代实现方案：

一、动态选择Feature文件路径 #

不用继承runner，靠Cucumber的配置扩展就能实现动态路径：

• 系统属性直接传递
  运行测试时通过JVM参数指定动态路径，比如根据环境变量切换：

  # Maven示例，根据test.env参数加载对应环境的feature
  mvn test -Dtest.env=prod -Dcucumber.features=src/test/resources/features/${test.env}/**/*.feature
  

• 自定义Cucumber配置类
  实现CucumberOptionsProvider接口，在代码里动态计算路径：

  public class EnvAwareCucumberOptions implements CucumberOptionsProvider {
      @Override
      public CucumberOptions getCucumberOptions() {
          // 从系统变量或配置文件拿环境标识，默认用dev
          String env = System.getProperty("test.env", "dev");
          String featurePath = String.format("src/test/resources/features/%s/**/*.feature", env);
          
          return new CucumberOptionsBuilder()
              .features(featurePath)
              .glue("com.your.stepdefs")
              .plugin("pretty", "json:target/cucumber-report.json")
              .build();
      }
  }
  

  然后在测试启动类上绑定这个配置：

  @RunWith(Cucumber.class)
  @CucumberOptionsProviderClass(EnvAwareCucumberOptions.class)
  public class RunCucumberTests {}
  

二、基于TestRail运行列表生成测试场景列表 #

核心是过滤要执行的场景，有两种实用方式：

1. 标签过滤法（简单直接） #

给每个feature场景加上和TestRail用例对应的标签（比如@testrail-1001），然后：

• 提前调用TestRail API获取当前运行计划里的用例ID，拼接成Cucumber标签表达式
• 通过系统参数传递给Cucumber：

  mvn test -Dcucumber.tags="@testrail-1001 or @testrail-1002 or @testrail-1003"
  

• 或者在自定义CucumberOptionsProvider里动态设置tags：

  private String getTestRailFilterTags() {
      // 这里实现调用TestRail API获取要运行的用例ID，拼接成标签表达式
      List<String> caseIds = fetchTestRailRunCaseIds();
      return String.join(" or ", caseIds.stream().map(id -> "@testrail-" + id).toList());
  }
  
  @Override
  public CucumberOptions getCucumberOptions() {
      return new CucumberOptionsBuilder()
          .features(...)
          .tags(getTestRailFilterTags())
          .build();
  }
  

2. 自定义Pickle过滤器（复杂场景） #

如果需要从场景描述、备注等地方提取TestRail ID，而不是依赖标签，可以实现PickleFilter接口：

public class TestRailPickleFilter implements PickleFilter {
      // 提前从TestRail获取要运行的用例ID集合
      private final Set<String> allowedCaseIds = fetchAllowedTestRailCaseIds();

      @Override
      public boolean matches(Pickle pickle) {
          // 从场景的名称、描述或标签中提取TestRail用例ID
          String caseId = extractTestRailCaseId(pickle);
          return allowedCaseIds.contains(caseId);
      }

      // 自定义实现提取逻辑，比如从场景描述里找"TestRail: 1001"这样的标记
      private String extractTestRailCaseId(Pickle pickle) {
          for (PickleStep step : pickle.getSteps()) {
              if (step.getText().contains("TestRail:")) {
                  return step.getText().split(":")[1].trim();
              }
          }
          return null;
      }
  }

然后通过SPI注册这个过滤器（在src/main/resources/META-INF/services/io.cucumber.core.filter.PickleFilter文件里添加你的过滤器类全路径），或者在Cucumber配置里指定。

三、替代ExtendedCucumber Runner的扩展方案 #

Cucumber 7.x用扩展点机制替代了原来的继承runner方式，常用的扩展方式：

1. 利用Cucumber内置扩展接口 #

根据你原来的扩展需求，选择对应的接口：

• BeforeAllCallback/AfterAllCallback：替代原来runner的初始化/收尾逻辑（比如加载TestRail配置、生成报告）
• EventListener：监听测试生命周期事件（比如场景开始/结束时同步TestRail结果）
• ParameterType：自定义参数解析逻辑

示例：用BeforeAllCallback提前加载TestRail数据：

public class TestRailSetup implements BeforeAllCallback {
      @Override
      public void beforeAll() {
          // 初始化TestRail客户端，拉取运行列表数据
          initTestRailClient();
          fetchTestRailRunData();
      }
  }

然后在CucumberOptions里注册这个扩展：

@RunWith(Cucumber.class)
@CucumberOptions(
    glue = "com.your.stepdefs",
    plugin = {"pretty", "com.your.extensions.TestRailSetup"}
)
public class RunCucumberTests {}

2. JUnit 5扩展（如果用JUnit 5） #

如果项目切换到JUnit 5，Cucumber提供@Cucumber注解，配合JUnit 5的Extension接口实现扩展：

public class TestRailJUnitExtension implements BeforeAllCallback {
      @Override
      public void beforeAll(ExtensionContext context) throws Exception {
          // 这里做TestRail初始化逻辑
          loadTestRailConfig();
      }
  }

测试类上绑定扩展：

@Cucumber
@ExtendWith(TestRailJUnitExtension.class)
public class RunCucumberTests {}

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