CentOS下Ruby结合无头ChromeDriver下载文件失败，求可行方案

你碰到的这个问题确实是无头Chrome的默认安全限制导致的——为了防范恶意脚本，无头模式下默认会拦截文件下载操作。不过通过正确配置Chrome选项和调用DevTools命令，完全可以解决这个问题，我来帮你梳理下可行的方案，以及你现有代码里需要调整的地方：

核心问题排查 #

你之前的代码思路是对的，但可能受限于Chrome版本兼容性、目录权限或者API调用方式的问题，导致没生效。下面是经过验证的完整修正方案：

修正后的可运行代码 #

require 'selenium-webdriver'
require 'pathname'

# 定义下载路径，确保用绝对路径
download_path = Pathname.pwd.join('test-data', 'downloaded').to_s
# 提前创建目录，Chrome不会自动创建不存在的下载目录
Dir.mkdir(download_path) unless Dir.exist?(download_path)

options = Selenium::WebDriver::Chrome::Options.new
# 重点：新版Chrome推荐使用--headless=new，旧版--headless在高版本中存在兼容性问题
options.add_argument('--headless=new')
options.add_argument('--disable-dev-shm-usage')
options.add_argument('--no-sandbox') # 部分环境（如Docker、CI）必须添加，避免权限拦截
options.add_argument('--disable-gpu') # 无头模式下可选，但某些系统需要

# 配置下载偏好
options.add_preference(:download, {
  directory_upgrade: true,
  prompt_for_download: false,
  default_directory: download_path
})
options.add_preference(:browser, {
  set_download_behavior: { behavior: 'allow', download_path: download_path }
})

# 初始化Chrome驱动
@driver = Selenium::WebDriver.for :chrome, options: options
$driver = @driver

# 关键：用Selenium 4+的CDP命令设置下载行为，比手动桥接更稳定
@driver.execute_cdp('Page.setDownloadBehavior', {
  behavior: 'allow',
  downloadPath: download_path
})

# 这里写你触发下载的逻辑，比如点击下载按钮
# @driver.find_element(:id, 'download-btn').click

关键调整说明 #

1. 切换到新版无头模式：Chrome 112版本之后，旧的--headless参数被标记为过时，--headless=new的行为更接近正常Chrome，对下载的支持更完善，这是很多人踩坑的点。
2. 确保下载目录存在：如果目标目录不存在，Chrome会直接拒绝写入，所以一定要提前用Dir.mkdir创建。
3. 使用CDP命令替代桥接调用：execute_cdp是Selenium 4提供的官方API，直接调用Chrome DevTools Protocol，比你之前手动拼接session路径的方式更可靠，也不容易出错。
4. 添加权限参数：--no-sandbox在无桌面环境的服务器或容器中是必须的，否则Chrome会因沙箱权限问题拦截下载操作。

额外排查建议 #

• 核对Chrome和ChromeDriver版本：两者必须严格匹配，版本不一致会导致各种奇怪的兼容性问题。
• 检查目录权限：确保运行脚本的用户对下载目录有写入权限，尤其是在Linux/macOS系统下。
• 验证触发下载的操作：确认你的代码确实正确定位并点击了下载元素，没有出现元素定位错误的情况。

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