IntelliJ中Cucumber Java集成测试重复执行问题求助

1. 锁定Cucumber测试的触发入口 #

问题核心是IntelliJ的测试扫描机制同时识别了Cucumber的step定义/feature文件和@Suite注解的Runner类，导致重复执行。给集成测试添加专属标签，并让Runner类只执行带该标签的测试：

• 在你的ITTestRunner类上明确指定标签筛选：

  @Suite
  @IncludeEngines("cucumber")
  @SelectPackages("com.yourpackage.it")
  @SelectTags("integration") // 只执行带integration标签的测试
  public class ITTestRunner {}
  

• 在集成测试的feature文件顶部添加标签：

  @integration
  Feature: 你的集成测试功能描述
  

  或者在step定义类上添加@Tag("integration")注解。

2. 严格区分单元/集成测试的Maven插件配置 #

确保Surefire只处理单元测试，Failsafe只处理集成测试，避免交叉执行：

Maven Surefire插件（单元测试，test/java目录） #

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.5</version>
    <configuration>
        <!-- 排除集成测试目录和Cucumber相关类 -->
        <excludes>
            <exclude>**/it/**</exclude>
            <exclude>**/*ITTestRunner.java</exclude>
            <exclude>**/*Cucumber*.*</exclude>
        </excludes>
        <!-- 只执行标准单元测试类 -->
        <includes>
            <include>**/*Test.java</include>
        </includes>
    </configuration>
</plugin>

Maven Failsafe插件（集成测试，it/java目录） #

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>3.2.5</version>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
            <configuration>
                <!-- 只执行集成测试Runner类 -->
                <includes>
                    <include>**/ITTestRunner.java</include>
                </includes>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 调整IntelliJ测试运行配置 #

避免IntelliJ自动扫描整个包导致重复执行：

• 打开Run/Debug Configurations，创建新的JUnit配置
• 在Configuration标签页：
  • 设置Test kind为Class
  • 在Class字段中选择你的ITTestRunner类
  • 取消勾选Include non-test classes选项
• 以后运行集成测试时，直接使用这个配置，而不是右键点击包选择"Run Tests"

4. 修复Test Containers连接拒绝问题 #

第二次执行时容器端口被占用或未正确销毁，添加全局销毁逻辑：

• 在ITTestRunner类中添加静态初始化块，强制测试结束后销毁容器：

  static {
      Testcontainers.stopContainersAfterTest();
      // 如果有暴露端口需求，指定端口
      // Testcontainers.exposeHostPorts(8080);
  }
  

• 或者在Cucumber Hook类中添加全局清理：

  public class CucumberIntegrationHooks {
      @AfterAll
      public static void cleanUpContainers() {
          Testcontainers.stopAllContainers();
      }
  }
  

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