Geckodriver在Java主方法正常，TestNG环境下无法运行问题

问题根源及修复方案 #

• 局部变量覆盖类变量：你代码里类级别的WebDriver driver;被setup方法内的WebDriver driver = new FirefoxDriver();重新定义成了局部变量，方法执行完后这个局部实例就会被销毁，不仅后续测试方法拿不到驱动，也可能导致驱动启动后立即关闭。直接给类变量赋值即可：driver = new FirefoxDriver();。

• Windows路径未转义：Java里反斜杠\是转义字符，路径里的C:\SOFTWARE\geckodriver.exe会被解析错误，改成C:\\SOFTWARE\\geckodriver.exe才能正确识别驱动文件位置。

• URL格式错误：http/www.google.com缺少了协议的冒号和双斜杠，正确写法是http://www.google.com，错误URL会导致浏览器无法加载页面，容易误以为驱动没启动。

• @BeforeMethod未触发的排查：

  • 确认测试类里有带@Test注解的测试方法，TestNG只会在测试方法执行前后触发@BeforeMethod/@AfterMethod，如果没有测试方法，setup不会执行。
  • 检查TestNG依赖是否正确引入，版本要和你的Java、Selenium版本兼容。
  • 查看TestNG的运行配置或xml文件，确保当前测试类被包含在执行范围内。

修正后的完整代码示例 #

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;

public class GoogleTest {
    WebDriver driver;

    @BeforeMethod
    public void setup() {
        // 修正路径转义
        System.setProperty("webdriver.gecko.driver", "C:\\SOFTWARE\\geckodriver.exe");
        // 给类级变量赋值，避免局部变量覆盖
        driver = new FirefoxDriver();
        // 修正URL格式
        driver.get("http://www.google.com");
        driver.manage().window().maximize();
        driver.manage().deleteAllCookies();
        driver.get("http://www.google.com");
    }

    // 必须添加@Test注解的测试方法，否则@BeforeMethod不会执行
    @Test
    public void verifyGoogleTitle() {
        String pageTitle = driver.getTitle();
        System.out.println("当前页面标题：" + pageTitle);
    }
}

额外排查建议 #

• 查看控制台输出的错误日志，比如是否有DriverNotFoundException（驱动找不到）、InvalidArgumentException（URL无效）这类提示，能快速定位问题。
• 确保Firefox浏览器版本和Geckodriver版本匹配，两者版本不兼容会直接导致驱动无法启动浏览器。

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