Cucumber自定义参数类型作为依赖引入其他项目无法创建表达式如何解决

问题根因 #

该问题的核心是自定义@ParameterType所在的类没有被Cucumber的Glue扫描逻辑识别到，具体分为两种常见场景：

1. Glue扫描路径未覆盖依赖包
   Cucumber默认仅扫描测试执行项目的当前包及其子包下的Glue相关类（包括参数类型注册类、Step定义类）。你作为依赖引入的Jar包中的CustomTypeRegistry类所在的包路径不在当前测试项目的Glue扫描范围内，因此Cucumber无法识别到类上的@ParameterType注解，也就不会注册对应的custom参数类型。
2. CustomTypeRegistry未被正确打入Jar包
   如果你的CustomTypeRegistry类存放在原项目的src/test/java目录下，Maven默认打包规则不会将测试目录下的类打入主Jar包，导致其他项目引入依赖后找不到该类，自然无法完成参数类型注册。

解决方案 #

1. 补充Glue扫描路径
   在测试项目的Cucumber启动配置中，将依赖Jar中CustomTypeRegistry所在的包路径加入Glue扫描列表。
   如果使用JUnit注解启动，配置示例：

@CucumberOptions(
    // 同时配置当前项目glue路径和依赖包的glue路径
    glue = {"com.your.local.project.glue", "com.dependency.project.cucumber.config"}
)

如果使用Cucumber CLI启动，新增--glue参数指定依赖包路径即可。

2. 调整打包配置
   将CustomTypeRegistry类迁移到原项目的src/main/java目录下，确保打包时会被包含进主Jar。如果必须放在测试目录，需要在原项目的pom.xml中配置测试Jar打包规则：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>test-jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

其他项目引入该依赖时，需要指定type为test-jar：

<dependency>
    <groupId>com.dependency.project</groupId>
    <artifactId>cucumber-config</artifactId>
    <version>1.0.0</version>
    <type>test-jar</type>
    <scope>test</scope>
</dependency>

3. 确认版本一致性
   检查两个项目的Cucumber核心依赖版本是否完全一致，避免跨版本兼容性导致的注解识别异常。

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