Spring Boot Maven项目集成JUnit与Cucumber的结构及运行配置咨询

针对你遇到的H2数据库管理、Maven模块依赖更新、测试运行效率问题，以下是具体修复和优化方案：

一、修正Cucumber与JUnit 5的兼容配置 #

你当前使用的@RunWith(Cucumber.class)是JUnit 4注解，和Spring Boot 2.7.x默认的JUnit 5环境冲突，需替换为Cucumber的JUnit 5适配方案：

1. 更新acceptance-test-module的pom.xml依赖，移除JUnit 4相关依赖，引入正确的Cucumber组件：

<dependencies>
    <!-- Spring Boot Test基础依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
        <!-- 排除JUnit 4依赖，避免冲突 -->
        <exclusions>
            <exclusion>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- Cucumber核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.11.0</version> <!-- 与Spring Boot 2.7.7兼容的版本 -->
        <scope>test</scope>
    </dependency>
    <!-- Cucumber与Spring集成依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-spring</artifactId>
        <version>7.11.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Cucumber JUnit 5运行器 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit-platform-engine</artifactId>
        <version>7.11.0</version>
        <scope>test</scope>
    </dependency>
    <!-- API模块依赖 -->
    <dependency>
        <groupId>你的项目groupId</groupId>
        <artifactId>api-module</artifactId>
        <version>${project.version}</version>
        <scope>testCompile</scope> <!-- 关键：用testCompile而非compile -->
    </dependency>
</dependencies>

2. 替换原有的Runner类，改用Cucumber上下文配置类：
   删除原带@RunWith注解的类，创建如下配置类即可：

package com.yourpackage.test.config;

import io.cucumber.spring.CucumberContextConfiguration;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;

@CucumberContextConfiguration
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.ANY)
public class CucumberSpringConfig {
}

二、解决Maven模块依赖更新问题 #

你修改代码后必须执行mvn clean install的核心原因是api-module的依赖范围设置错误：

• 将acceptance-test-module中api-module的依赖范围改为testCompile后，Maven会直接引用api-module的编译产物（target/classes目录），而非本地仓库的jar包。修改api-module或验收测试代码后，只需重新编译对应模块，即可直接运行测试，无需执行install操作。

三、优化H2数据库生命周期管理 #

通过Spring Boot自动配置完全接管H2数据库的启停，避免手动管理问题：

1. 在acceptance-test-module的src/test/resources/application.yaml中配置H2：

spring:
  datasource:
    url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
    driver-class-name: org.h2.Driver
    username: sa
    password:
  jpa:
    hibernate:
      ddl-auto: create-drop # 测试结束自动删除表，避免数据残留
    show-sql: true
  h2:
    console:
      enabled: true # 可选，方便调试

2. 确保CucumberSpringConfig类上的@AutoConfigureTestDatabase注解正确，Spring Boot会在测试启动时自动创建H2内存库，测试结束后自动销毁，无需手动启停。

四、简化测试运行方式 #

修复配置后，你可以灵活运行测试：

• IDE单文件测试：右键单个.feature文件或步骤定义类，直接选择运行，无需依赖全局Runner类。
• Maven命令运行：执行mvn test -pl acceptance-test-module即可运行验收测试模块的所有测试；若要运行特定标签的测试，可添加参数：mvn test -pl acceptance-test-module -Dcucumber.filter.tags="@smoke"。
• 无需单独Runner类：JUnit Platform会自动扫描classpath下的feature文件和步骤定义，原有的Runner类可以删除。

五、验证项目结构合理性 #

你的多模块结构符合最佳实践：api-module专注业务逻辑开发，acceptance-test-module独立负责验收测试，分离关注点。只需确保：

• feature文件放在src/test/resources/features目录下，步骤定义类放在src/test/java对应的包路径下，Cucumber会自动扫描匹配。
• 所有依赖版本保持兼容（Spring Boot 2.7.7对应Cucumber 7.x版本）。

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