使用TestNG套件结合Selenium Hub时Firefox挂起（连接拒绝错误）求助

我碰到过不少开发者在做跨浏览器测试套件时，遇到Firefox挂起不退出、TestNG配置报错的问题，结合你给出的ThreadLocal Driver代码片段，咱们一步步拆解解决：

一、Firefox挂起无法自行退出的问题 #

这个问题大多和WebDriver实例未正确释放、版本兼容或配置缺失有关，对应解决方案如下：

• 务必在测试结束后清理ThreadLocal Driver实例
  ThreadLocal的特性是每个线程持有独立实例，如果测试结束后不主动移除并关闭，会导致Firefox进程残留挂起。一定要在@AfterMethod或@AfterClass中做清理：

  @AfterMethod
  public void tearDown() {
      RemoteWebDriver currentDriver = driver.get();
      if (currentDriver != null) {
          currentDriver.quit(); // 这里必须用quit()而非close()，quit会彻底终止浏览器进程
          driver.remove(); // 从ThreadLocal中移除实例，避免内存泄漏
      }
  }
  

• 检查版本兼容性
  Selenium Hub、GeckoDriver、Firefox浏览器三者版本必须匹配，比如：

  • Selenium 4.x 对应 GeckoDriver 0.33+、Firefox 115+
    如果版本不匹配，很容易出现进程无法正常终止的情况，建议去官方文档确认对应版本后统一升级/降级。

• 优化FirefoxOptions配置
  添加必要的启动参数，避免因系统环境限制导致进程挂起：

  FirefoxOptions options = new FirefoxOptions();
  // 解决Linux环境下的沙箱问题
  options.addArguments("--no-sandbox");
  // 避免/dev/shm内存不足导致的异常
  options.addArguments("--disable-dev-shm-usage");
  // 远程连接Hub时，将配置传入RemoteWebDriver
  driver.set(new RemoteWebDriver(new URL("http://your-hub-url:4444/wd/hub"), options));
  

• 配置Selenium Hub会话超时
  如果Hub节点的会话没有自动回收，也会导致Firefox进程残留。启动Hub时添加超时参数：

  java -jar selenium-server-4.x.jar hub --session-timeout 300
  

  300代表300秒，超过时间Hub会自动销毁残留会话。

二、TestNG配置错误的问题 #

结合你用ThreadLocal做线程安全的场景，大概率是并行配置或注解使用不当导致的：

• 正确配置TestNG并行模式
  使用ThreadLocal时，推荐用methods或tests级别并行，避免suite级别导致的实例混乱。TestNG XML示例：

  <suite name="DIPTestSuite" parallel="methods" thread-count="5">
      <test name="FirefoxTestSuite">
          <classes>
              <class name="your.package.DIPTestConfigureDriver"/>
          </classes>
      </test>
  </suite>
  

• 确保Driver在@BeforeMethod中初始化
  每个测试方法都要初始化独立的RemoteWebDriver实例，避免线程间共享：

  @BeforeMethod
  public void setUp() throws MalformedURLException {
      FirefoxOptions options = new FirefoxOptions();
      // 这里添加你的Firefox配置
      driver.set(new RemoteWebDriver(new URL("http://localhost:4444/wd/hub"), options));
  }
  

• 避免静态变量冲突
  除了ThreadLocal本身是static的，其他和Driver相关的变量或方法不要用static修饰，确保每个线程持有独立的实例。

额外调试建议 #

• 开启Firefox日志：通过FirefoxOptions配置日志输出，定位挂起的具体原因：

  options.setLogLevel(FirefoxDriverLogLevel.TRACE);
  options.addArguments("-log", "/path/to/your/firefox-debug.log");
  

• 查看Selenium Hub日志：启动Hub时添加-debug参数，查看会话创建、销毁的完整流程，排查是否有异常。

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