如何将Excel读取的Tag传入Cucumber框架Runner类的Cucumber Options？

Cucumber的@CucumberOptions注解属于编译期配置，其中tags参数要求是编译时常量，所以无法直接传入运行时从Excel读取的变量。要实现动态指定Tag触发测试，可通过以下两种常用方式解决：

方法1：通过系统属性动态覆盖Tag（推荐） #

利用Cucumber的特性：当你通过系统属性cucumber.filter.tags指定Tag时，会优先覆盖@CucumberOptions中配置的静态Tag。步骤如下：

1. 在测试启动前读取Excel并设置系统属性
   在测试Runner类的初始化方法中，调用你的ExcelReader读取Tag，然后将其设置为系统属性：

   import org.junit.jupiter.api.BeforeAll;
   import org.junit.runner.RunWith;
   import io.cucumber.junit.Cucumber;
   import io.cucumber.junit.CucumberOptions;
   
   @RunWith(Cucumber.class)
   @CucumberOptions(
       features = "src/test/resources/features",
       glue = "com.yourpackage.stepdefinitions",
       tags = "" // 留空或设默认Tag，会被系统属性覆盖
   )
   public class TestRunner {
       @BeforeAll
       public static void loadTagFromExcel() {
           // 调用你的ExcelReader读取Tag
           String targetTag = ExcelReader.getRequiredTag();
           // 设置Cucumber识别的系统属性
           System.setProperty("cucumber.filter.tags", targetTag);
       }
   }
   

   若使用TestNG，可替换为@BeforeSuite注解的方法来执行初始化逻辑。

2. ExcelReader示例（补充读取逻辑）
   假设你的ExcelReader核心读取方法如下：

   public class ExcelReader {
       public static String getRequiredTag() {
           // 你的Excel读取逻辑，比如从指定单元格获取Tag（例："@smoke"）
           // 此处替换为你已实现的代码
           return "@smoke";
       }
   }
   

方法2：编程式启动Cucumber测试（灵活度更高） #

直接使用Cucumber的Main类启动测试，动态传入读取到的Tag参数，完全绕过@CucumberOptions的静态限制：

import io.cucumber.core.cli.Main;

public class DynamicTestRunner {
    public static void main(String[] args) {
        // 读取Excel中的Tag
        String tagFromExcel = ExcelReader.getRequiredTag();
        
        // 构建Cucumber运行参数
        String[] cucumberArgs = {
            "--glue", "com.yourpackage.stepdefinitions",
            "--features", "src/test/resources/features",
            "--tags", tagFromExcel
        };
        
        // 启动Cucumber测试
        Main.run(cucumberArgs, Thread.currentThread().getContextClassLoader());
    }
}

关键说明 #

• 若使用Cucumber 7及以上版本，还可以在@CucumberOptions中直接引用系统属性，实现默认值+动态覆盖的效果：

  @CucumberOptions(
      tags = "${cucumber.filter.tags:@defaultTag}" // 未设置系统属性时用@defaultTag
  )
  

• 确保Excel读取逻辑在Cucumber加载测试配置前执行，否则系统属性无法生效。

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