如何从命令行运行Cucumber Spring Boot打包Jar？启动报错求助

我之前踩过Cucumber-JVM结合Spring Boot打包的类路径坑，结合你的情况（Eclipse运行正常、打包后报错），给你几个针对性的排查和解决方向：

1. 先检查依赖范围与打包插件配置 #

这是最常见的问题根源：Eclipse会自动包含所有源码和依赖，但打包时如果依赖范围不对，会直接排除Cucumber的backend类。

Maven配置示例（Gradle思路类似） #

确保你的pom.xml满足两个条件：

• Cucumber核心依赖（cucumber-spring、cucumber-java）的scope正确：如果你的step定义、backend代码在src/main/java下，用compile；如果在src/test/java下，用test（但要注意，默认Spring Boot打包不会包含test目录的类，后面会说处理方式）。
• Spring Boot打包插件配置正确，确保所有依赖被打包进可执行Jar：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${spring-boot.version}</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

<dependencies>
    <!-- 示例：Cucumber Spring依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-spring</artifactId>
        <version>${cucumber.version}</version>
        <scope>compile</scope> <!-- 若代码在main目录用compile，test目录用test -->
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

2. 验证打包后的Jar是否包含backend类 #

用命令行检查Jar内容，确认你的backend类有没有被打包进去：

jar tf your-app.jar | grep "你的backend包路径"

比如你的backend代码在com.example.cucumber.backend，就执行jar tf your-app.jar | grep "com/example/cucumber/backend"。如果没有输出，说明类没被打包，回头检查依赖范围或源码目录配置。

3. 调整启动类与扫描范围 #

如果你的应用是通过Spring Boot主类启动，要确保主类能扫描到Cucumber的backend组件：

@SpringBootApplication(scanBasePackages = {"com.example.app", "com.example.cucumber.backend"})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

如果你的目的是运行Cucumber测试，直接用Cucumber的主类启动更合适，修改Spring Boot插件配置指定启动类：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring-boot.version}</version>
    <configuration>
        <mainClass>io.cucumber.core.cli.Main</mainClass>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

启动时传入Cucumber参数：

java -jar your-app.jar --glue com.example.cucumber.backend src/test/resources/features

4. 处理test目录下的Cucumber代码 #

如果你的backend代码在src/test/java，默认Spring Boot打包不会包含这部分类。可以通过以下方式解决：

• 把Cucumber代码移到src/main/java目录（推荐，适合需要在生产环境运行Cucumber逻辑的场景）。
• 用maven-jar-plugin打包测试Jar，再通过插件把它合并到可执行Jar中：

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

5. 确认版本兼容性 #

Cucumber和Spring Boot的版本必须匹配：

• Spring Boot 2.x 对应 Cucumber 6.x ~ 7.x
• Spring Boot 3.x 对应 Cucumber 7.10+
  如果版本不兼容，也可能出现类找不到的异常。

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