TestNG结合Cucumber时@BeforeClass与@BeforeMethod不执行问题求助

核心原因 #

1. Cucumber与TestNG生命周期冲突
   步骤定义类中的TestNG注解（@BeforeClass/@BeforeMethod）不会被执行，因为AbstractTestNGCucumberTests已经接管了测试生命周期——Cucumber会自行实例化步骤类并管理其执行流程，TestNG无法干预步骤类的注解触发。

2. Runner类中添加TestNG注解破坏Cucumber报告生成
   将@BeforeClass/@BeforeMethod移到Runner类后，TestNG的前置逻辑会干扰Cucumber的测试上下文初始化，导致Cucumber无法正确追踪步骤执行记录，最终生成空的JSON报告。

解决方案 #

1. 用Cucumber钩子替代TestNG前置注解 #

Cucumber提供了自己的钩子注解来管理测试前后操作，结合ThreadLocal实现并行测试的线程安全：

步骤1：在Runner类中接收TestNG参数并存储

public class TestRunner extends AbstractTestNGCucumberTests {
    private static final ThreadLocal<String> BROWSER = new ThreadLocal<>();

    @Parameters("browser")
    @BeforeClass(alwaysRun = true)
    public void initBrowser(String browserName) {
        BROWSER.set(browserName);
    }

    // 提供静态方法供步骤类获取浏览器参数
    public static String getCurrentBrowser() {
        return BROWSER.get();
    }
}

步骤2：在步骤定义类中使用Cucumber钩子

public class StepDefinitions {
    private WebDriver driver;

    // Cucumber方法级前置钩子，替代TestNG的@BeforeMethod
    @Before
    public void setupDriver() {
        String browser = TestRunner.getCurrentBrowser();
        switch (browser.toLowerCase()) {
            case "chrome":
                driver = new ChromeDriver();
                break;
            case "safari":
                driver = new SafariDriver();
                break;
            default:
                throw new IllegalArgumentException("Unsupported browser: " + browser);
        }
    }

    @Given("I open the application")
    public void openApplication() {
        driver.get("your-app-url");
    }

    // Cucumber方法级后置钩子
    @After
    public void teardownDriver() {
        if (driver != null) {
            driver.quit();
            BROWSER.remove(); // 清理ThreadLocal资源
        }
    }
}

2. 确保TestNG XML配置正确 #

并行测试需指定parallel="tests"模式，每个测试节点对应一个浏览器参数：

<suite name="Parallel Browser Tests" parallel="tests" thread-count="2">
    <test name="Chrome Test">
        <parameter name="browser" value="chrome"/>
        <classes>
            <class name="com.yourpackage.TestRunner"/>
        </classes>
    </test>
    <test name="Safari Test">
        <parameter name="browser" value="safari"/>
        <classes>
            <class name="com.yourpackage.TestRunner"/>
        </classes>
    </test>
</suite>

原理说明 #

• Cucumber钩子（@Before/@After）由Cucumber自身触发，能与步骤执行流程完全对齐，保证前置操作在每个场景前执行。
• ThreadLocal用于存储每个线程的浏览器参数，避免并行测试中不同浏览器实例互相干扰。
• Runner类中的@BeforeClass仅负责接收TestNG参数并传递，不会干扰Cucumber的报告生成逻辑。

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