Capybara Selenium无头Chrome远程调试端口配置问题求助

我之前踩过这个坑，给你梳理几个靠谱的解决办法，应该能帮你搞定：

1. 用新版无头模式+正确配置Chrome参数 #

旧版的--headless参数和远程调试兼容性一般，Chrome 112+推出了新版无头模式--headless=new，不仅更稳定，还完美支持远程调试。同时要确保把调试端口参数正确加到ChromeOptions里，还要加上一些避免环境问题的辅助参数：

Capybara.register_driver :selenium_chrome_headless_debug do |app|
  options = Selenium::WebDriver::Chrome::Options.new
  # 新版无头模式，支持远程调试
  options.add_argument('--headless=new')
  # 设置远程调试端口，选一个未被占用的端口（比如9222、9521都可以）
  options.add_argument('--remote-debugging-port=9222')
  # 避免权限问题（尤其是容器/CI环境）
  options.add_argument('--no-sandbox')
  # 解决共享内存不足的问题
  options.add_argument('--disable-dev-shm-usage')
  # 可选：设置窗口大小，避免元素定位问题
  options.add_argument('--window-size=1920,1080')

  Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
end

# 设置默认驱动为调试用的配置
Capybara.default_driver = :selenium_chrome_headless_debug

2. 检查端口是否被占用 #

如果指定的调试端口被其他程序占用，Chrome启动会失败，Selenium自然连不上。你可以用下面的命令检查端口状态：

• Mac/Linux：在终端执行 lsof -i :9222，如果有输出说明端口被占用，换个端口就行
• Windows：在命令提示符执行 netstat -ano | findstr :9222，查看是否有进程占用该端口

3. 确保Chrome和ChromeDriver版本匹配 #

版本不兼容也是常见问题，ChromeDriver的版本必须和你的Chrome浏览器版本一致（大版本相同即可，比如Chrome 120对应ChromeDriver 120.x.x）。你可以在终端执行google-chrome --version和chromedriver --version检查版本是否匹配，不匹配的话下载对应版本的ChromeDriver即可。

4. 正确连接调试端口 #

启动测试后，打开本地Chrome浏览器，输入chrome://inspect，点击页面中的「Configure」按钮，添加localhost:9222，稍等几秒就能看到正在运行的无头Chrome实例，点击「inspect」就可以打开调试工具，像调试普通Chrome一样查看元素、断点调试了。

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