Cucumber/JUnit并行测试：动态生成Runner文件导入cucumber.api问题解决

核心原因 #

1. 依赖冲突：项目中同时存在Cucumber 1.x/2.x旧版依赖（包路径cucumber.api）和新版（4.x+，包路径io.cucumber）依赖，构建工具或IDE优先加载了旧包类，导致动态生成的Runner使用旧导入路径。
2. IDE/插件缓存与版本问题：Cucumber IDE插件版本过旧，不支持新版包结构；或IDE缓存未更新，仍保留旧的代码生成逻辑。
3. 并行插件兼容性：使用的第三方并行测试插件（如cucumber-jvm-parallel-plugin）版本未适配新版Cucumber，生成的Runner代码仍基于旧包结构。

修复方法 #

1. 清理依赖冲突 #

• Maven：执行mvn dependency:tree查看依赖树，找出所有旧版Cucumber依赖并排除：

  <dependencies>
      <!-- 新版Cucumber核心依赖 -->
      <dependency>
          <groupId>io.cucumber</groupId>
          <artifactId>cucumber-java</artifactId>
          <version>7.14.0</version>
          <scope>test</scope>
      </dependency>
      <dependency>
          <groupId>io.cucumber</groupId>
          <artifactId>cucumber-junit-platform-engine</artifactId>
          <version>7.14.0</version>
          <scope>test</scope>
      </dependency>
  </dependencies>
  
  <!-- 排查并排除旧依赖 -->
  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-dependency-plugin</artifactId>
              <version>3.6.0</version>
              <executions>
                  <execution>
                      <phase>validate</phase>
                      <goals>
                          <goal>tree</goal>
                      </goals>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

  找到旧依赖后，在对应的依赖节点中添加<exclusions>排除cucumber.api或info.cukes相关包。

• Gradle：执行./gradlew dependencies查看依赖树，通过配置全局排除旧依赖：

  dependencies {
      testImplementation 'io.cucumber:cucumber-java:7.14.0'
      testImplementation 'io.cucumber:cucumber-junit-platform-engine:7.14.0'
      testImplementation 'org.junit.platform:junit-platform-suite:1.9.3'
  }
  
  configurations.all {
      // 排除所有旧版Cucumber依赖
      exclude group: 'cucumber.api', module: '*'
      exclude group: 'info.cukes', module: '*'
  }
  

2. 更新IDE与插件 #

• 升级IDE的Cucumber插件到最新版本（IntelliJ/Eclipse插件市场搜索Cucumber for Java），确保插件支持io.cucumber包结构。
• 清理IDE缓存：IntelliJ通过File -> Invalidate Caches...清理后重启；Eclipse通过Project -> Clean清理项目缓存。

3. 调整并行测试配置 #

推荐使用Cucumber官方支持的JUnit Platform（JUnit 5）实现并行，无需第三方插件：

1. 引入JUnit Platform依赖（见上述Maven/Gradle配置）。
2. 创建自定义测试类代替动态生成的Runner：

   import org.junit.platform.suite.api.ConfigurationParameter;
   import org.junit.platform.suite.api.IncludeEngines;
   import org.junit.platform.suite.api.SelectPackages;
   import org.junit.platform.suite.api.Suite;
   
   import static io.cucumber.junit.platform.engine.Constants.PARALLEL_CONFIGURATION_PROPERTY_NAME;
   import static io.cucumber.junit.platform.engine.Constants.PLUGIN_PROPERTY_NAME;
   
   @Suite
   @IncludeEngines("cucumber")
   @SelectPackages("com.your.project.stepdefs") // 替换为你的步骤定义包路径
   @ConfigurationParameter(key = PLUGIN_PROPERTY_NAME, value = "pretty, html:target/cucumber-report.html")
   @ConfigurationParameter(key = PARALLEL_CONFIGURATION_PROPERTY_NAME, value = "true")
   public class CucumberParallelSuite {
   }
   

若坚持使用第三方并行插件，需升级插件到兼容新版Cucumber的版本（如cucumber-jvm-parallel-plugin 5.0.0+），并在配置中指定新版包：

<plugin>
    <groupId>com.github.temyers</groupId>
    <artifactId>cucumber-jvm-parallel-plugin</artifactId>
    <version>5.0.0</version>
    <executions>
        <execution>
            <id>generate-runners</id>
            <phase>generate-test-sources</phase>
            <goals>
                <goal>generateRunners</goal>
            </goals>
            <configuration>
                <glue>com.your.project.stepdefs</glue>
                <packageName>com.your.project.runners</packageName>
                <junit5>true</junit5> <!-- 开启JUnit5支持，对应新版Cucumber -->
            </configuration>
        </execution>
    </executions>
</plugin>

4. 验证修复 #

执行mvn clean test或./gradlew clean test，检查动态生成的Runner文件导入路径是否变为io.cucumber，同时确认测试能正常并行运行。

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