如何复用Cucumber SpringBoot测试实现本地与远程集成测试？

核心思路是通过条件化Spring上下文配置，结合@Profile和Cucumber的统一配置类，实现根据激活的环境profile切换测试上下文，同时复用同一套Cucumber用例。

1. 统一Cucumber配置类 #

创建唯一的@CucumberContextConfiguration标注类，内部通过静态类结合@Profile实现不同环境的上下文切换：

@CucumberContextConfiguration
public class CucumberEnvConfig {

    // 本地环境：启动完整SpringBoot应用
    @Profile("local")
    @SpringBootTest(classes = YourApplication.class)
    static class LocalTestContext {}

    // 远程环境（qa/prod等）：仅加载远程调用所需的最小配置
    @Profile("!local")
    @ContextConfiguration(classes = RemoteTestContext.class)
    static class RemoteTestContext {}
}

2. 远程环境上下文配置 #

创建远程测试专用的配置类，仅加载远程调用依赖的Bean（如RestTemplate、FeignClient），并绑定对应环境的配置文件：

@Configuration
@PropertySource("classpath:application-${spring.profiles.active}.properties")
public class RemoteTestContext {

    // 配置远程调用客户端
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }

    // 若使用Feign，可在此配置FeignClient相关Bean
}

3. 环境配置文件 #

创建对应环境的配置文件，存放环境特定参数：

• application-local.properties：本地测试无需额外配置（@SpringBootTest会自动加载应用默认配置）
• application-qa.properties：配置远程服务地址等参数

# application-qa.properties
remote.service.base-url=https://qa.your-service.com/api

4. 复用步骤定义（Step Definitions） #

在步骤类中通过条件注入Bean，适配不同环境的测试逻辑：

public class BusinessStepDefinitions {

    private final RestTemplate restTemplate;
    private final YourService localService;

    // 构造函数注入：local环境下localService会被注入，远程环境下为null
    public BusinessStepDefinitions(RestTemplate restTemplate, @Autowired(required = false) YourService localService) {
        this.restTemplate = restTemplate;
        this.localService = localService;
    }

    @Given("用户提交了请求")
    public void userSubmitsRequest() {
        if (localService != null) {
            // 本地测试：直接调用应用内Service
            localService.processRequest();
        } else {
            // 远程测试：调用远程接口
            restTemplate.postForObject(
                "${remote.service.base-url}/submit",
                requestBody,
                Response.class
            );
        }
    }
}

5. 运行测试 #

通过Maven命令指定激活的profile，Spring会自动加载对应上下文：

• 本地测试：

mvn verify -Dspring.profiles.active=local

• QA环境测试：

mvn verify -Dspring.profiles.active=qa

关键说明 #

• 利用@Profile实现上下文的条件加载，确保local环境启动完整SpringBoot应用，远程环境仅加载最小配置，符合最小化ApplicationContext要求；
• 唯一的@CucumberContextConfiguration类解决了Cucumber仅允许单个配置类的限制；
• 命令行指定spring.profiles.active参数，确保Spring仅使用对应环境的配置文件。

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