如何将CucumberContextConfiguration迁移至共享库并关联测试运行器？

核心问题分析 #

你遇到的两个问题本质都是Cucumber的Glue路径配置或类扫描范围问题：

• 运行Runner类报错是因为Cucumber在指定的Glue路径下找不到带@CucumberContextConfiguration的配置类；
• 移配置类到测试项目后找不到步骤定义，是因为Glue路径没覆盖共享库的步骤定义包，或者Spring没扫描到共享库中的步骤类。

解决方案 #

1. 修正Glue路径覆盖所有必要类 #

你的Runner类中GLUE_PROPERTY_NAME的配置必须同时包含共享库的配置类包和步骤定义类包。如果步骤定义在共享库的其他包（比如com.shared.steps），用逗号分隔多个路径：

@Cucumber
@IncludeEngines("cucumber")
@SelectClasspathResource("com/tests")
@ConfigurationParameter(key = GLUE_PROPERTY_NAME, value = "com.runner.project.test,com.shared.steps")
public class RunnerTest {  
}

这样Cucumber才能同时找到上下文配置和所有步骤定义。

2. 确保共享库配置类的扫描范围正确 #

修改共享库中的MyTestContext类，显式指定@ComponentScan的扫描路径，确保能覆盖到步骤定义类：

@CucumberContextConfiguration
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)
@EnableConfigurationProperties
@EnableAutoConfiguration
@ComponentScan(basePackages = {"com.runner.project.test", "com.shared.steps"}) // 替换为实际步骤定义包
@Import(Config.class)
public class MyTestContext {

    @Configuration
    public static class Config {....}
}

3. 验证共享库的依赖引入 #

确保测试项目的pom.xml中，共享库是作为test范围依赖引入的，避免类加载不到：

<dependency>
    <groupId>你的共享库GroupId</groupId>
    <artifactId>你的共享库ArtifactId</artifactId>
    <version>对应版本号</version>
    <scope>test</scope>
</dependency>

4. 解决配置类移到测试项目后的步骤识别问题 #

如果把MyTestContext移到测试项目，需要：

• 在Runner的Glue路径中加入测试项目的配置类包和共享库的步骤定义包；
• 确保共享库的步骤定义类上带有@Component注解，让Spring能扫描并加载这些类到上下文。

关键注意点 #

Cucumber的Glue路径是用来定位步骤定义类和Cucumber上下文配置类的核心配置，必须保证所有相关类都在Glue指定的包路径下，或者被Spring的扫描机制覆盖。使用共享库时，一定要确认共享库的类能被测试项目的类路径正确加载。

内容的提问来源于stack exchange，提问作者Денис Кондратов