Cucumber依赖导入异常：import cucumber.annotation.en.Given无法解析

这个问题我帮不少开发者排查过，核心原因是Cucumber版本迭代后包结构发生了重大变化——你用的cucumber.annotation.en.*是Cucumber 1.x版本的旧包路径，而当前主流的Cucumber 2+版本已经把注解迁移到了新的包下，同时groupId也从info.cukes改成了io.cucumber。下面是具体的解决步骤：

1. 替换注解的包路径 #

把所有旧的注解导入语句替换为新的路径：

• 旧导入：import cucumber.annotation.en.Given;
• 新导入：import io.cucumber.java.en.Given;

同理，When、Then、And等其他注解也要同步替换，比如：

import io.cucumber.java.en.Given;
import io.cucumber.java.en.When;
import io.cucumber.java.en.Then;

2. 检查并更新Maven依赖配置 #

确保你的pom.xml里使用的是Cucumber 2+版本的依赖，groupId为io.cucumber，而不是旧的info.cukes。以下是一个稳定的依赖配置示例：

<dependencies>
    <!-- Cucumber Java核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Cucumber JUnit集成依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
    <!-- Selenium Java依赖 -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>4.11.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

注意：请保持cucumber-java和cucumber-junit的版本一致，避免版本冲突。

3. 刷新Maven依赖并清理IDE缓存 #

• 首先在项目根目录执行Maven命令，刷新依赖并重新构建：

  mvn clean install -U
  

• 如果IDE仍然报错，清理IDE缓存后重启：
  • IntelliJ IDEA：File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启
  • Eclipse：Project -> Clean...，选择你的项目后执行清理

4. 排查依赖冲突 #

如果以上步骤都无效，检查是否存在新旧版本的Cucumber依赖冲突：

• 执行mvn dependency:tree命令，查看依赖树，确认是否有info.cukes开头的旧依赖被间接引入
• 如果有，在对应的依赖中添加<exclusions>排除旧版本的Cucumber依赖

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