You need to enable JavaScript to run this app. Java环境下Selenium启动ChromeDriver出现驱动服务启动超时异常求助
优惠活动
大模型
产品
解决方案
定价
更多

Java环境下Selenium启动ChromeDriver出现驱动服务启动超时异常求助

Selenium ChromeDriver启动超时问题排查与修复

异常核心逻辑

你遇到的org.openqa.selenium.WebDriverException: 等待驱动服务器启动超时,触发机制很直接:Selenium客户端拉起ChromeDriver进程后,会在默认20秒的时间窗口内反复访问ChromeDriver暴露的本地状态接口,确认服务正常可用;如果超过时间没拿到响应就会抛出该异常。哪怕日志里已经打印“ChromeDriver已成功启动”的提示,只要本地通信链路不通,就会触发这个报错。

常见触发原因与对应解决方案

  • 版本协议不兼容
    你当前用的Selenium客户端是3.141.59版本(2018年发布),搭配的ChromeDriver是89.0.4389.23版本(2021年发布),两个版本的本地通信接口存在协议差异。尤其是在Java 15环境下,旧版Selenium内置的Guava工具类版本过低,和高版本ChromeDriver的通信逻辑不匹配,是触发这类超时的最高发原因。
    • 处理方案:要么把ChromeDriver降级到和3.141.59匹配的旧版本(适配Chrome 70-75的ChromeDriver 2.4x系列);要么直接把Selenium客户端升级到4.x稳定版本,不要长期停留在多年未更新的3.141.59版本上。
  • 本地host地址解析不匹配
    报错日志里显示Selenium探测的接口地址是http://localhost:46362/status,部分Windows10环境下,localhost会优先解析到IPv6地址::1,但ChromeDriver 89默认只监听IPv4的127.0.0.1地址,两边地址对不上就会直接探测超时。
    • 处理方案:在程序最开头、所有Selenium初始化代码之前加配置,强制Java优先使用IPv4协议通信:
      System.setProperty("java.net.preferIPv4Stack", "true");
      
      同时检查系统hosts文件,确认127.0.0.1 localhost的映射规则没有被篡改。
  • 安全软件拦截本地端口监听
    Windows Defender、系统防火墙、第三方安全软件的防护规则,可能会拦截ChromeDriver对本地回环端口的绑定请求。这种情况下ChromeDriver虽然能正常打印启动日志,但实际端口并没有开放,自然拿不到接口响应。
    • 处理方案:把chromedriver.exe和Java运行程序加入防火墙的允许通行列表,临时关闭安全软件的实时监控后再重新运行测试。
  • 驱动路径权限异常
    你当前配置的驱动路径在F:\Selenium\...目录下,如果该目录的访问权限不足,或者路径嵌套过深、带特殊字符,也可能导致ChromeDriver进程启动后没法正常绑定端口。
    • 处理方案:把chromedriver.exe挪到路径简单、无特殊字符、权限充足的目录下(比如C:\tools\chromedriver.exe),修改代码里的驱动路径配置后再测试。

可选优化手段

如果排查完以上问题仍存在超时,可以手动延长Selenium等待驱动启动的超时窗口,避免默认20秒的等待时间不够用:

ChromeDriverService service = new ChromeDriverService.Builder()
        .usingDriverExecutable(new File("C:\\tools\\chromedriver.exe"))
        .usingAnyFreePort()
        .withTimeout(Duration.ofSeconds(60))
        .build();
service.start();
WebDriver driver = new ChromeDriver(service);

内容的提问来源于stack exchange,提问作者Jisha Sreyas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 23:06:03