Cucumber 4.5.x升级至5.x/6.x遇Scenario导入路径问题求助

一、Scenario类的正确导入路径 #

Cucumber 4.x到6.x的包结构有明显调整，对应版本的正确导入如下：

• Cucumber 4.x：import io.cucumber.core.api.Scenario
• Cucumber 5.x及以上：统一使用import io.cucumber.java.Scenario（注意你之前用的io.cucumber.core.gherkin.Scenario是内部API，不建议用于业务代码，后续版本可能被移除）

如果导入io.cucumber.java.Scenario仍找不到类，说明你的Maven依赖配置存在问题，缺少核心依赖。

二、修正Maven依赖配置 #

你的原依赖存在版本不兼容问题（比如用7.0.2版本的cucumber-expressions搭配4.5.2版本的cucumber-core），必须统一Cucumber家族所有依赖的版本，并移除不必要的冗余依赖。

1. 统一Cucumber版本 #

建议升级到稳定的新版本（比如7.x，兼容性和功能比6.x更完善），在pom.xml的properties中设置统一版本：

<properties>
    <java.version>11</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <selenium.version>4.3.0</selenium.version>
    <!-- 可替换为你目标的版本，如6.11.0（6.x稳定版）或7.14.0（7.x稳定版） -->
    <cucumber.version>7.14.0</cucumber.version>
    <junit5.version>5.9.2</junit5.version>
</properties>

2. 正确的核心依赖列表 #

移除冗余依赖，仅保留必要的核心组件（cucumber-java已包含expressions、datatable、gherkin等所需组件）：

<dependencies>
    <!-- Cucumber核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit 5适配依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit-platform-engine</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>

    <!-- JUnit 5引擎依赖 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>${junit5.version}</version>
        <scope>test</scope>
    </dependency>

    <!-- Selenium依赖 -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>${selenium.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

3. 需移除的旧依赖 #

以下依赖均可删除，因为cucumber-java已间接包含这些组件，单独引入会导致版本冲突：

• io.cucumber:cucumber-core
• io.cucumber:cucumber-expressions
• io.cucumber:cucumber-dependencies
• io.cucumber:cucumber-datatable_1.1.14
• io.cucumber:cucumber.gherkin（注意原groupId格式错误，且无需单独引入）
• io.cucumber:cucumber-tag-expressions

三、执行步骤 #

1. 修改pom.xml中的cucumber.version为目标版本，替换所有旧的Scenario导入为import io.cucumber.java.Scenario
2. 删除pom.xml中冗余、版本不匹配的Cucumber依赖
3. 执行命令mvn clean install -U（-U参数强制更新依赖）
4. 在IntelliJ中点击「Reload All Maven Projects」，确保依赖加载完成

关键注意事项 #

• 禁止混合不同版本的Cucumber依赖，否则会引发类加载冲突或找不到类的问题
• 不要使用io.cucumber.core.gherkin.Scenario这类内部API，避免后续版本兼容性问题

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