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中调整以下配置,把默认的重试逻辑放大:
如果使用本地Selenium Standalone服务,启动时手动把会话超时参数调整为3600s,覆盖默认的5分钟空闲断连规则。connectionRetryCount: 10, connectionRetryTimeout: 120000, waitforTimeout: 20000, - 优化浏览器资源占用
无头模式启动参数增加内存优化配置,解决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
相关产品推荐
相关产品推荐

