Cucumber/Selenium Maven项目：已定义Java步骤仍出现未定义问题

问题场景 #

我搭建了一个基于Maven的简易自动化测试项目，使用Selenium WebDriver配合Cucumber执行基础测试，项目结构配置如下：

• 步骤定义类（.java）存放于src/test/java下的对应包内
• .feature文件已放置在标记为测试资源根目录的src/test/resources文件夹中

运行时出现Undefined step错误，Cucumber无法匹配.feature文件中的步骤与对应的Java步骤定义。已尝试更新IntelliJ IDEA、确保运行配置的glue字段指向步骤定义所在包等方案，但问题仍未解决。

具体排查方案 #

1. 统一Cucumber依赖版本 #

检查pom.xml中所有Cucumber相关依赖（如cucumber-java、cucumber-junit、cucumber-core）的版本是否一致，版本不兼容是步骤匹配失败的常见原因。示例正确依赖配置：

<dependencies>
    <!-- Cucumber 核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.15.0</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>7.15.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Selenium 依赖 -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>4.11.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 严格匹配步骤文本与注解内容 #

确保.feature文件中的步骤文本（包括空格、标点、大小写）与Java步骤定义的@Given/@When/@Then注解内的文本完全一致。例如：

• .feature中的步骤：Given 打开亚马逊首页
• Java步骤定义必须对应：@Given("打开亚马逊首页")，不能存在任何字符差异

3. 校验运行配置的glue路径 #

在IntelliJ的Cucumber运行配置中，glue字段需填写步骤定义所在的完整包名（如com.mahmood.tests.steps），不要填写具体类名。同时确认该包下的步骤定义类为public访问权限，且位于src/test/java目录内。

4. 确认Maven测试资源配置 #

检查pom.xml是否正确配置测试资源目录，确保src/test/resources被Maven识别为测试资源：

<build>
    <testResources>
        <testResource>
            <directory>src/test/resources</directory>
        </testResource>
    </testResources>
</build>

5. 清理缓存并重新构建 #

执行Maven命令清理项目缓存并重新构建：

mvn clean test

同时在IntelliJ中执行File → Invalidate Caches... → 勾选Clear file system cache and local history → 点击Invalidate and Restart，清除IDE缓存后重试测试。

6. 检查注解导入正确性 #

确保步骤定义类中导入的是Cucumber官方注解，避免导入其他框架的同名注解：

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

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