Azure远程Linux代理WebdriverIO Chromedriver非无头模式实例化报错求助

问题核心原因 #

非无头模式下的Chrome需要图形界面环境才能启动，而默认的Linux远程代理通常没有安装X11相关组件，导致Chrome启动失败，进而引发Chromedriver连接被拒绝的错误（connect ECONNREFUSED 127.0.0.1:42947）。

是否需要额外组件？ #

是的，必须安装X11虚拟显示服务及Chrome运行依赖组件，才能让非无头模式的Chrome在无图形界面的Linux代理上正常运行。

具体解决步骤 #

• 安装Xvfb（虚拟X服务器）
  Xvfb可以模拟图形显示环境，让Chrome非无头模式无需物理显示器即可启动。

  • Debian/Ubuntu系统：

    sudo apt-get update && sudo apt-get install xvfb -y
    

  • RHEL/CentOS系统：

    sudo yum install xorg-x11-server-Xvfb -y
    

• 集成Xvfb到WebdriverIO测试流程
  推荐使用wdio-xvfb-service自动管理Xvfb生命周期：

  1. 安装依赖：

     npm install wdio-xvfb-service --save-dev
     

  2. 在wdio.conf.ts中配置服务：

     export const config: WebdriverIO.Config = {
       // 其他已有配置...
       services: ['chromedriver', 'xvfb'],
       xvfbOpts: {
         displayNum: 99, // 指定虚拟显示器编号
         silent: true, // 关闭Xvfb日志输出
         xvfbArgs: ['-screen', '0', '1920x1080x24'] // 设置分辨率和颜色深度
       }
     }
     

• 补全Chrome运行依赖
  检查Chrome是否缺少必要的系统库，运行以下命令查看缺失项：

  ldd $(which google-chrome) | grep not found
  

  针对Debian/Ubuntu系统，安装常见缺失库：

  sudo apt-get install libnss3 libatk1.0-0 libcups2 libxss1 libxrandr2 libasound2 libpangocairo-1.0-0 libgtk-3-0 -y
  

• 排查Chromedriver与Chrome版本兼容性
  确保Chromedriver版本和安装的Chrome主版本完全匹配，版本不兼容会导致Chrome启动失败，进而触发连接拒绝错误。可以通过google-chrome --version查看Chrome版本，再下载对应版本的Chromedriver。

• 固定Chromedriver端口避免冲突
  在wdio.conf.ts中指定Chromedriver的固定端口，防止随机端口被占用：

  export const config: WebdriverIO.Config = {
    // 其他已有配置...
    services: [
      ['chromedriver', {
        port: 9515 // 使用Chromedriver默认端口
      }]
    ]
  }
  

内容的提问来源于stack exchange，提问作者curiosity