Selenium FirefoxDriver每次启动因GeckoDriver更新的TCP连接错误超时30秒，寻求解决方案

我完全理解你每次跑测试都要等30秒超时的烦躁——明明本地已经有可用的GeckoDriver，却还要被自动更新检查卡住，太影响效率了！结合你的场景（企业代理环境+本地已装GeckoDriver），给你几个针对性的解决方案，按推荐优先级排序：

1. 禁用Selenium Manager自动驱动检测（最推荐） #

Selenium 4之后默认会用Selenium Manager组件自动检测、下载对应版本的驱动，你的超时问题就是这个组件在请求GitHub的GeckoDriver更新地址时，没走企业代理导致的。既然你已经把GeckoDriver放在Windows的PATH里了，完全可以直接跳过这个自动检查：

两种实现方式： #

• 方式一：添加JVM启动参数
  在运行测试的命令里加上：

  -Dselenium-manager.disable=true
  

• 方式二：代码里提前设置系统属性
  要在创建FirefoxDriver实例之前设置，代码示例：

  // 先禁用Selenium Manager的自动管理
  System.setProperty("selenium-manager.disable", "true");
  
  // 再初始化你的FirefoxOptions和Driver
  final FirefoxOptions opts = new FirefoxOptions();
  if (BooleanUtils.isTrue(this.browserIsHeadless)) {
      opts.addArguments("--headless");
  }
  // 保留你原本的其他配置（比如无头模式）
  this.setDriver(new FirefoxDriver(opts));
  

  这个方法从根源上切断了更新检查逻辑，直接用本地已有的驱动，彻底解决超时问题。

2. 给Selenium Manager单独配置代理 #

如果企业允许通过代理访问外部GitHub地址，你可以给Selenium Manager设置代理（注意：这和Firefox浏览器的代理是分开的，之前你设置的Firefox偏好只影响浏览器本身，不影响Selenium Manager）：

代码里设置系统属性： #

// 在创建Driver之前设置代理参数
System.setProperty("http.proxyHost", "你的企业代理主机");
System.setProperty("http.proxyPort", "代理端口");
System.setProperty("https.proxyHost", "你的企业代理主机");
System.setProperty("https.proxyPort", "代理端口");

// 如果代理需要用户名密码，再加上下面两行
System.setProperty("http.proxyUser", "你的代理用户名");
System.setProperty("http.proxyPassword", "你的代理密码");
System.setProperty("https.proxyUser", "你的代理用户名");
System.setProperty("https.proxyPassword", "你的代理密码");

// 然后正常初始化Driver
final FirefoxOptions opts = new FirefoxOptions();
// ...你的配置
this.setDriver(new FirefoxDriver(opts));

这样Selenium Manager就能通过代理正常访问更新地址，不会超时，还能继续自动管理驱动版本。

3. 手动指定GeckoDriver路径 #

如果你不想完全禁用Selenium Manager，也可以直接告诉Selenium本地GeckoDriver的具体位置，跳过网上检查：

// 指定本地GeckoDriver的绝对路径
System.setProperty("webdriver.gecko.driver", "C:\\你的路径\\geckodriver.exe");

// 然后正常初始化Driver
final FirefoxOptions opts = new FirefoxOptions();
// ...你的配置
this.setDriver(new FirefoxDriver(opts));

这个方法也能绕过更新检查，直接使用你指定的本地驱动。

4. 缩短Selenium Manager超时时间（备选方案） #

如果前面的方法都无法实施，只能退而求其次，把超时时间从30秒缩短到1秒：

// 设置超时为1000毫秒（1秒）
System.setProperty("selenium-manager.timeout", "1000");

// 然后正常初始化Driver
final FirefoxOptions opts = new FirefoxOptions();
// ...你的配置
this.setDriver(new FirefoxDriver(opts));

这样就算更新检查失败，也只会卡1秒就继续执行测试。

补充说明： #

你之前尝试的那些Firefox偏好设置（比如network.proxy.type、app.update.auto）之所以没用，是因为这些配置只影响Firefox浏览器本身，而超时是Selenium的独立组件Selenium Manager在请求更新地址时发生的，所以修改浏览器的配置对它没有作用。

备注：内容来源于stack exchange，提问作者Vincent Passau