Cucumber-jvm：Cucumber Hook与TestNG Hook冲突引发运行报错求助

我之前踩过类似的坑，结合你给出的错误栈信息，这个问题主要是Cucumber与TestNG依赖版本不兼容、关键依赖缺失，再加上两种框架钩子的执行逻辑冲突共同导致的。下面给你一步步的解决方案：

1. 优先修复依赖问题 #

错误里的NoClassDefFoundError: io/cucumber/tagexpressions/TagExpressionParser是核心线索——这个类属于cucumber-tag-expressions包，要么是你没引入这个依赖，要么是Cucumber各组件的版本不统一。

统一Cucumber与TestNG依赖版本 #

确保所有Cucumber相关依赖（包括和TestNG集成的包）版本完全一致，推荐使用Cucumber 7.x系列的稳定版（比如7.14.0），下面是Maven的配置示例：

<dependencies>
    <!-- Cucumber核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Cucumber与TestNG集成依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-testng</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- TestNG依赖 -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>7.8.0</version>
        <scope>test</scope>
    </dependency>
    <!-- 自动引入tag-expressions等依赖，无需单独声明 -->
</dependencies>

如果是Gradle，对应调整依赖配置即可，核心是保证Cucumber组件版本统一。

2. 调整钩子的使用逻辑，避免冲突 #

你同时使用了TestNG的@BeforeTest和Cucumber的@Before，这两个钩子的执行时机和上下文完全不同：

• TestNG的@BeforeTest是在整个Test Suite的所有测试开始前执行，此时Cucumber的Scenario、Feature等上下文对象还未初始化；
• Cucumber的@Before是在每个Scenario执行前执行，此时Cucumber的上下文已经准备完毕。

如果你的@BeforeTest方法里尝试调用了Cucumber相关的对象（比如在TestRunner的第105行操作Feature对象），就会触发NullPointerException。

钩子使用建议 #

• 如果是初始化Cucumber相关的资源（比如Scenario级别的配置），完全用Cucumber的钩子：用@Before做每个Scenario的前置，用@BeforeAll（Cucumber 7+支持）做全局初始化；
• 如果是TestNG层面的全局初始化（比如启动测试服务、初始化全局驱动），确保@BeforeTest里的逻辑不依赖任何Cucumber的上下文对象。

举个正确的钩子示例：

// Cucumber全局初始化钩子
@BeforeAll
public static void cucumberGlobalSetup() {
    // 这里做Cucumber全局准备，比如加载配置文件
}

// Cucumber每个Scenario前置钩子
@Before
public void cucumberScenarioSetup(Scenario scenario) {
    // 这里可以安全使用Scenario对象
    System.out.println("开始执行Scenario: " + scenario.getName());
}

// TestNG全局初始化钩子（不依赖Cucumber上下文）
@BeforeTest
public void testngGlobalSetup() {
    // 这里做TestNG层面的全局初始化，比如启动Selenium驱动
    driver = new ChromeDriver();
}

3. 检查TestRunner类的配置 #

错误指向Runner.TestRunner.features(TestRunner.java:105)，你需要检查这一行的代码：

• 是否是features路径配置错误（比如路径不存在、拼写错误）；
• 是否在@BeforeTest里提前调用了Cucumber还未加载的Feature相关对象，如果是，把这部分逻辑移到Cucumber的@BeforeAll或者@Before里。

按上面的步骤调整后，应该能解决你遇到的NPE和NoClassDefFoundError问题。

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