NodeJS项目测试中Selenium连接Firefox报ExceptionInInitializerError的修复

本次抛出的异常并非单纯由版本兼容性直接触发，核心故障点是Selenium无法与本地自动拉起的geckodriver进程建立通信链路，版本不匹配、本地网络栈解析问题都是常见诱因。

异常核心定位 #

从栈信息可直接定位故障点：

故障发生在FirefoxDriver初始化阶段，Selenium尝试连接本地随机端口时被拒绝：
java.net.ConnectException: Failed to connect to localhost/0:0:0:0:0:0:0:1:32528
出现该报错的本质是geckodriver进程未在对应端口正常监听服务，而非业务测试逻辑本身的问题。后续抛出的NoClassDefFoundError是静态代码块初始化失败后的连锁反应，只要解决第一次FirefoxDriver初始化的连接问题，该连锁报错会自动消失。

常见触发原因 #

• Windows环境IPv6本地回环解析不兼容
  Java 1.8在Windows系统下默认会优先将localhost解析为IPv6地址::1，但geckodriver 0.24版本默认仅监听IPv4的127.0.0.1地址，会直接导致连接被拒绝。数周前同版本Selenium能正常运行，多是因为之前的项目环境做过IPv4优先的配置，新项目未同步对应配置。
• 组件版本适配偏差
  当前使用的Selenium 3.141.59 + geckodriver 0.24 + Firefox 86.0的组合存在适配边界问题：geckodriver 0.24的官方支持范围最高到Firefox 85，Firefox 86启动后会因协议特性不兼容导致geckodriver进程直接退出，端口无监听服务，自然出现连接失败。之前能正常运行，大概率是Firefox未自动升级到86.0版本。
• geckodriver路径配置错误
  若系统环境变量未正确指向geckodriver 0.24的可执行文件，Selenium可能随机拉起内置的旧版geckodriver进程，该进程与当前Firefox版本不兼容时会直接崩溃，无法正常提供端口服务。

分步修复方案 #

1. 配置JVM强制使用IPv4栈解析地址
   在初始化WebDriver前添加全局属性配置，绕过IPv6解析的兼容问题：

   // 强制Java优先使用IPv4网络栈
   System.setProperty("java.net.preferIPv4Stack", "true");
   // 显式指定geckodriver的本地可执行文件路径
   System.setProperty("webdriver.gecko.driver", "你的本地geckodriver.exe完整路径");
   

2. 对齐组件版本适配范围
   完成上述配置后若仍报错，根据使用场景调整版本：
   • 若需保留现有Selenium 3.141版本，将Firefox降级到85及以下的长期支持版本即可正常兼容geckodriver 0.24。
   • 若需保留Firefox 86不做降级，将geckodriver升级到0.29.1版本即可（该版本是与Selenium 3.141、Firefox 86匹配的稳定组合，更高版本的geckodriver会因通信协议不兼容与Selenium 3.141出现交互故障）。
3. 固定geckodriver的监听地址
   给geckodriver服务显式指定IPv4监听地址，避免随机端口的偶发解析问题：

   FirefoxOptions options = new FirefoxOptions();
   GeckoDriverService geckoService = new GeckoDriverService.Builder()
           .usingAnyFreePort()
           .withHost("127.0.0.1") // 强制监听IPv4回环地址
           .build();
   WebDriver driver = new FirefoxDriver(geckoService, options);
   

前置验证步骤 #

• 启动测试前，可在命令行直接运行geckodriver可执行文件，观察是否能正常输出端口监听日志。若进程启动后直接闪退，说明geckodriver文件损坏或版本与Firefox不匹配，需重新替换对应版本的文件。
• 确认本地系统防火墙未拦截Java、geckodriver进程对本地回环端口的访问权限。

内容的提问来源于stack exchange，提问作者Alba Aparicio Perez