Selenoid中Capybara+Rspec测试时浏览器无法正常展示的配置问题

核心错误原因 #

• Capability 键名错误
  原配置中使用的caps['"enableVNC"']存在语法错误，"是HTML转义的双引号，并非实际需要的键名。同时enableVNC需要传Ruby布尔值true，而非字符串格式的'True'。
  另外 Selenoid 的自定义扩展配置（包括 enableVNC、screenResolution、timeZone 等）必须放在专属的selenoid:options命名空间下，直接写在根级 Capability 里会被 Selenoid 忽略，默认返回 false。
• Capybara 驱动配置不匹配
  原设置的Capybara.javascript_driver = :selenium_chrome_headless是 Capybara 自带的本地 Chrome 驱动，会直接调用本地浏览器执行测试，完全不会连接 Selenoid 服务。单独调用的Selenium::WebDriver.for方法仅临时创建了WebDriver实例，未绑定到 Capybara 的驱动体系，Rspec 执行测试时不会用到该实例。
• Capability 字段名不兼容
  Selenoid 识别的浏览器版本字段为version，而非browserVersion，字段名错误会导致 Selenoid 无法匹配对应浏览器镜像，间接引发配置失效。

正确配置示例 #

Capybara + Rspec 配置（替换原有 spec_helper.rb 内容） #

Capybara.default_max_wait_time = 5

# 注册自定义远程 Selenoid 驱动
Capybara.register_driver :selenoid_chrome do |app|
  # 基础浏览器能力配置
  caps = Selenium::WebDriver::Remote::Capabilities.chrome(
    browserName: 'chrome',
    version: '88.0'
  )
  # Selenoid 专属配置放在命名空间下
  caps['selenoid:options'] = {
    enableVNC: true,
    screenResolution: '1920x1080x24'
  }

  Capybara::Selenium::Driver.new(
    app,
    browser: :remote,
    url: 'http://localhost:4444/wd/hub',
    desired_capabilities: caps
  )
end

# 切换 Capybara 驱动到自定义的 Selenoid 远程驱动
Capybara.javascript_driver = :selenoid_chrome
Capybara.current_driver = :selenoid_chrome

独立 Selenium 脚本配置（替换原有测试脚本内容） #

caps = Selenium::WebDriver::Remote::Capabilities.new(
  browserName: 'chrome',
  version: '88'
)
# Selenoid 专属配置
caps['selenoid:options'] = {
  enableVNC: true
}

driver = Selenium::WebDriver.for(
  :remote,
  url: 'http://127.0.0.1:4444/wd/hub',
  desired_capabilities: caps
)

driver.get 'https://www.google.com'
sleep 5
driver.quit

注意事项 #

• Selenoid 容器内的浏览器默认就是无界面运行，无需额外配置 Chrome 的 headless 参数，开启 enableVNC 后即可通过 Web 控制台可视化查看运行过程。
• 运行测试前需确认 Selenoid 服务已正常启动，且对应版本的 Chrome 镜像已拉取完成。

验证方式 #

配置修改后重新运行测试，访问 Selenoid 状态接口http://localhost:8080/status，对应会话的caps字段下enableVNC会显示为true，此时即可在 Selenoid Web 控制台的对应会话页查看浏览器运行过程。 #

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