You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Rails5+RSpec+Selenium+webdrivers遇Webdrivers::BrowserNotFound报错求助

解决Webdrivers::BrowserNotFound:无法找到Chrome二进制文件的问题

从你的错误日志和配置来看,核心问题不是chromedriver没下载,而是webdrivers gem找不到Chrome浏览器本身——这个gem的工作逻辑是先检测本地Chrome的版本,再匹配下载对应版本的chromedriver,所以第一步得确保Chrome浏览器已经正确安装,并且能被webdrivers检测到。

下面分场景给你具体解决方案:

1. 先确认Chrome浏览器是否已安装

本地开发环境

检查你的Chrome是否在默认路径:

  • Mac:/Applications/Google Chrome.app
  • Windows:C:\Program Files\Google\Chrome\Application\chrome.exe
  • Linux:/usr/bin/google-chrome

如果Chrome装在非默认路径,或者用的是Chromium,需要手动指定路径。

Docker环境(从日志的/usr/local/bundle推测你可能用了容器)

如果是Docker部署,你的镜像里大概率没安装Chrome浏览器,需要在Dockerfile里添加安装步骤:

# 基于Ruby镜像的话,添加以下命令安装Chrome及依赖字体
RUN apt-get update && apt-get install -y \
    google-chrome-stable \
    fonts-ipafont-gothic fonts-wqy-zenhei fonts-thai-tlwg fonts-kacst fonts-freefont-ttf \
    --no-install-recommends \
    && rm -rf /var/lib/apt/lists/*

安装完成后,在容器内执行which google-chrome可以确认路径是否为/usr/bin/google-chrome。

2. 手动指定Chrome二进制文件路径

如果Chrome不在默认路径,或者webdrivers没自动检测到,你可以在rails_helper.rb的Capybara驱动配置里添加路径指定:

Capybara.register_driver :selenium_chrome_headless do |app|
  browser_options = ::Selenium::WebDriver::Chrome::Options.new
  # 添加这行指定Chrome路径,替换成你的实际路径
  browser_options.binary = '/usr/bin/google-chrome' # Linux/Docker示例
  # browser_options.binary = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' # Mac示例
  browser_options.args << '--headless'
  browser_options.args << '--no-sandbox'
  browser_options.args << '--disable-gpu'
  Capybara::Selenium::Driver.new(app, browser: :chrome, options: browser_options)
end

另外,也可以通过设置环境变量GOOGLE_CHROME_BIN来指定路径,webdrivers gem会自动读取这个变量的值。

3. 额外排查步骤

  • 确认版本兼容性:你用的webdrivers 4.1.2和Selenium 3.142.3是兼容的,但如果问题依旧,可以尝试更新到webdrivers的最新兼容版本(4.x系列适配Selenium 3.x)。
  • 手动触发chromedriver下载:在Rails控制台执行Webdrivers::Chromedriver.update,观察输出日志,确认Chrome是否被正常检测到。

按照上面的步骤操作后,应该就能解决Failed to find Chrome binary的问题,让测试正常运行了。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.14 08:26:55