使用Gradle执行TestNG测试、Cucumber场景时WebDriver调用异常求助

我之前也遇到过类似的场景：用Gradle整合TestNG和Cucumber写自动化测试，本地跑没问题，一到Jenkins流水线执行gradle test就报错，排查下来大多和WebDriver的初始化或环境配置有关。结合你的情况，给你几个实用的排查和解决方向：

1. 调整WebDriver的初始化时机 #

别在测试类的构造方法或静态代码块里初始化WebDriver——Jenkins的CI环境类加载机制和本地不一样，静态初始化的驱动很容易实例失败。建议把初始化逻辑放到Cucumber Hooks的@Before注解方法里：

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import io.cucumber.java.Before;

public class TestHooks {
    private WebDriver driver;

    @Before
    public void setupDriver() {
        // 后续可以换成WebDriverManager自动管理，先手动指定路径验证
        System.setProperty("webdriver.chrome.driver", "/var/lib/jenkins/chromedriver");
        driver = new ChromeDriver();
    }
}

2. 用WebDriverManager自动管理驱动（强烈推荐） #

手动指定驱动路径很容易在本地/Jenkins环境出现路径不一致的问题，用webdrivermanager依赖可以自动下载匹配当前浏览器的驱动版本：

• 先在Gradle构建脚本里加依赖：

dependencies {
    testImplementation 'io.github.bonigarcia:webdrivermanager:5.6.3'
    // 别忘了Cucumber和TestNG的核心依赖
    testImplementation 'io.cucumber:cucumber-java:7.14.0'
    testImplementation 'io.cucumber:cucumber-testng:7.14.0'
    testImplementation 'org.testng:testng:7.8.0'
}

• 然后修改初始化代码：

import io.github.bonigarcia.wdm.WebDriverManager;

@Before
public void setupDriver() {
    WebDriverManager.chromedriver().setup();
    driver = new ChromeDriver();
}

3. 给Jenkins配置Headless无头模式 #

Jenkins服务器一般没有图形界面，直接启动Chrome会崩溃，必须配置无头运行参数：

import org.openqa.selenium.chrome.ChromeOptions;

@Before
public void setupDriver() {
    WebDriverManager.chromedriver().setup();
    ChromeOptions options = new ChromeOptions();
    options.addArguments("--headless=new");
    options.addArguments("--disable-gpu");
    options.addArguments("--no-sandbox"); // 解决Jenkins环境的权限限制问题
    options.addArguments("--disable-dev-shm-usage"); // 避免临时文件空间不足
    driver = new ChromeDriver(options);
}

4. 检查Gradle的TestNG+Cucumber运行配置 #

确保你的Gradle脚本正确关联了TestNG套件和Cucumber的执行逻辑，比如：

test {
    useTestNG() {
        suites 'src/test/resources/testng.xml' // 指定你的TestNG配置文件
    }
    // 把系统参数传递给测试，方便调试
    systemProperties System.getProperties()
    // 确保测试报告能正常生成，方便排查问题
    testLogging {
        events "passed", "skipped", "failed"
    }
}

5. 深挖Jenkins日志找具体报错 #

如果上面的步骤都没解决，一定要去Jenkins看gradle test的完整日志，重点找：

• WebDriver初始化时的异常栈（比如是不是提示找不到驱动、权限不够）
• Cucumber场景执行到哪一步时崩溃的

把具体的异常信息贴出来，能更快定位问题~

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