如何在Robot Framework中配置无头Chrome实现文件下载及使用Page.setDownloadBehavior？

嘿，刚好之前在项目里折腾过这个问题，这就给你梳理清楚怎么配置：

1. 先搞懂核心逻辑 #

无头Chrome出于安全考虑，默认会阻止文件下载，所以必须做两个关键配置：

• 给Chrome设置下载目录的偏好参数，告诉它把文件存哪
• 通过Chrome DevTools Protocol（CDP）的Page.setDownloadBehavior命令，明确告诉浏览器允许下载行为——这步在无头模式下是必须的，光设置偏好还不够

2. 结合你的代码实现完整配置 #

你给的代码已经有了基础的ChromeOptions框架，我帮你补充完善，加入CDP命令的调用，完整的关键字实现如下：

*** Settings ***
Library    Selenium2Library
Library    Collections
Library    OperatingSystem

*** Keywords ***
Create Chrome Browser
    [Arguments]    ${link_to_open}    ${DOWNLOADS_DIR}
    # 初始化ChromeOptions对象
    ${chrome_options}=    Evaluate    sys.modules['selenium.webdriver'].ChromeOptions()    sys, selenium.webdriver
    # 配置下载目录的偏好设置
    ${prefs}=    Create Dictionary    download.default_directory=${DOWNLOADS_DIR}
    Call Method    ${chrome_options}    add_experimental_option    prefs    ${prefs}
    # 添加无头模式相关参数（用新版无头模式更稳定）
    Call Method    ${chrome_options}    add_argument    --headless=new
    Call Method    ${chrome_options}    add_argument    --disable-gpu
    # 创建Chrome浏览器实例
    ${driver}=    Create Webdriver    Chrome    chrome_options=${chrome_options}
    # 让Selenium2Library关联这个新创建的driver
    Selenium2Library.Set Webdriver    ${driver}
    # 关键！通过CDP命令允许下载行为
    ${download_config}=    Create Dictionary    behavior=allow    downloadPath=${DOWNLOADS_DIR}
    Call Method    ${driver}    execute_cdp_cmd    Page.setDownloadBehavior    ${download_config}
    # 打开目标链接
    Selenium2Library.Go To    ${link_to_open}

几个重要的修改点： #

• 修正了你代码里${chrome options}的拼写错误（变量名不能有空格，应该是${chrome_options}）
• 加入了add_experimental_option来注入下载目录的偏好配置
• 改用了--headless=new参数——这是Chrome的新版无头模式，比旧的--headless兼容性更好，支持更多下载场景
• 创建driver后，必须调用execute_cdp_cmd执行Page.setDownloadBehavior，这是无头模式下启用下载的核心步骤
• 补充了Set Webdriver，确保Selenium2Library能正确使用我们创建的浏览器实例

额外要注意的坑 #

• ${DOWNLOADS_DIR}必须是绝对路径！比如Linux下的/home/yourname/test_downloads，Windows下的C:\\Users\\yourname\\test_downloads，用相对路径大概率会下载失败
• 如果你的Selenium版本比较旧，可能需要调整execute_cdp_cmd的调用方式，但目前主流的Selenium 4.x版本都支持这个方法
• 下载文件后记得加等待逻辑，比如用Wait Until File Exists来确认文件已经下载完成，避免后续操作报错

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