You need to enable JavaScript to run this app. WebdriverIO v7+Cucumber测试随机报ConnectException连接被拒排查
优惠活动
大模型
产品
解决方案
定价
更多

WebdriverIO v7+Cucumber测试随机报ConnectException连接被拒排查

错误本质定位

从错误栈看,抛出java.net.ConnectException: Connection refused的位置是WDIO向本地WebDriver服务发送browser.url()指令的交互环节,和被测应用的网络连通性无关,本质是测试脚本和本地驱动服务之间的TCP连接被拒绝,常见触发原因完全匹配观测到的无规律随机失败的特征。

高频触发成因
  • 本地驱动进程意外被杀
    WDIO v7默认采用单驱动会话复用逻辑,驱动进程从测试启动就一直常驻,每跑一个场景会逐步累积内存、句柄占用。跑满4个场景后,驱动往往因为内存泄漏、系统资源占用超限,被Windows Defender、进程内存管理机制强制终止,后续发请求时自然会连接被拒。
    无头模式更容易复现这个问题:无头Chrome的资源管控比带GUI的模式更严格,内存溢出阈值更低,跑几个场景就容易崩溃;非无头模式下因为有GUI进程的保活机制,驱动不容易被杀,偶尔会出现全量通过的情况。
  • 驱动会话被服务端主动超时断开
    本地启动的Selenium Standalone、ChromeDriver默认带5分钟的空闲会话超时,如果某一段钩子逻辑、批量循环操作(比如代码里的forEach循环批量删除愿望列表)执行时间过长、中途没有给驱动发指令,服务端会主动关闭这个会话,后续操作就会报连接被拒。
  • 驱动绑定的本地端口被抢占
    驱动启动时绑定的本地随机端口,可能被本地其他程序(IDE调试进程、残留的旧测试进程、企业代理软件)临时占用,下一次发请求时就会连接失败。
  • WDIO v7 sync模式的已知连接复用bug
    v7版本在开启全局长等待、使用sync命令包装模式时,存在固定场景数触发的连接池超时问题,没有内置的自动重连逻辑,跑够一定数量的场景后就会随机抛出连接错误。
可落地的排查&修复步骤
  • 先确认驱动存活状态
    在WDIO配置的beforeStep钩子里,每次步骤执行前打印当前驱动的PID、绑定端口,同时打开Windows任务管理器监控驱动进程。报错发生时如果发现驱动进程已经从列表消失,优先把本地Chrome/Edge版本和对应驱动版本做严格匹配,避免版本不兼容导致的驱动崩溃。
  • 覆盖默认的连接超时配置
    直接在wdio.conf中调整以下配置,把默认的重试逻辑放大:
    connectionRetryCount: 10,
    connectionRetryTimeout: 120000,
    waitforTimeout: 20000,
    
    如果使用本地Selenium Standalone服务,启动时手动把会话超时参数调整为3600s,覆盖默认的5分钟空闲断连规则。
  • 优化浏览器资源占用
    无头模式启动参数增加内存优化配置,解决Windows环境下临时内存分区不足导致的驱动崩溃:
    args: [
      '--headless=new',
      '--disable-dev-shm-usage',
      '--disable-gpu',
      '--no-sandbox',
      '--js-flags="--max-old-space-size=4096"'
    ]
    
  • 关闭系统代理对本地请求的拦截
    在WDIO配置中添加proxy: false,强制所有WebDriver交互请求直连localhost,不走系统代理;临时把项目路径加入Windows Defender的实时防护排除列表,避免安全软件误杀驱动进程。
  • 验证驱动复用逻辑的问题
    临时调整配置,设置每个场景跑完后关闭当前驱动、重新启动新的驱动实例。如果调整后随机报错消失,说明原有的长会话复用逻辑就是问题根源,可以直接对长耗时的循环操作增加定时的驱动心跳请求,避免会话空闲超时。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.26 12:06:06