在Jenkins中配置Robot Framework默认下载目录及解决ChromeDriver问题

咱们先拆解你遇到的两个核心问题：chromedriver路径报错和下载目录不生效，这俩都是Jenkins环境下跑Robot脚本的常见坑，我给你针对性的解决方案和重构后的代码。

1. 解决chromedriver不在PATH的问题 #

Jenkins的运行环境和本地桌面环境的PATH变量是完全分开的，所以本地能找到chromedriver，Jenkins不一定能。有两种可靠的解决方式：

方式一：在Jenkins全局配置中添加chromedriver路径 #

• 进入Jenkins的「Manage Jenkins」→「Global Tool Configuration」
• 找到「ChromeDriver」配置项，指定chromedriver的安装路径（比如/opt/chromedriver或者Windows下的C:\tools\chromedriver.exe）
• 保存后，在你的Jenkins任务中勾选「Install ChromeDriver」选项，让Jenkins自动管理驱动路径

方式二：在Robot脚本中直接指定chromedriver绝对路径 #

如果不想改Jenkins全局配置，也可以在脚本里硬编码驱动的绝对路径（适合固定部署环境）：

${CHROMEDRIVER_PATH}    /opt/chromedriver  # Windows下写C:\\tools\\chromedriver.exe
Create Webdriver    Chrome    executable_path=${CHROMEDRIVER_PATH}    chrome_options=${chrome_options}

2. 配置Jenkins环境下的默认下载目录 #

Chrome在无头模式（Jenkins通常用无头运行浏览器）下的下载配置需要额外参数，而且要确保Jenkins运行用户对目标目录有读写权限。关键配置点：

• 设置download.default_directory指定绝对路径
• 添加profile.default_content_settings.popups=0禁用下载弹窗
• 无头模式下需要开启--disable-dev-shm-usage和--no-sandbox避免权限问题
• 提前创建目标目录，防止因为目录不存在导致下载失败

重构后的完整代码块 #

*** Settings ***
Library    SeleniumLibrary
Library    OperatingSystem

*** Variables ***
${TARGET_URL}    https://example.com/your-download-page
${DOWNLOAD_DIR}    /var/jenkins_home/downloads  # Windows下写C:\\Jenkins\\downloads
${CHROMEDRIVER_PATH}    /opt/chromedriver  # 根据你的实际路径修改

*** Test Cases ***
Download File To Specified Directory
    # 提前创建下载目录，确保权限正确
    Create Directory    ${DOWNLOAD_DIR}    recursive=True
    # 配置Chrome浏览器选项
    ${chrome_options}    Evaluate    sys.modules['selenium.webdriver'].ChromeOptions()    sys
    # 设置下载目录
    ${prefs}    Create Dictionary    download.default_directory=${DOWNLOAD_DIR}    profile.default_content_settings.popups=0
    Call Method    ${chrome_options}    add_experimental_option    prefs    ${prefs}
    # 添加无头模式及必要参数（Jenkins环境必须）
    Call Method    ${chrome_options}    add_argument    --headless=new
    Call Method    ${chrome_options}    add_argument    --disable-gpu
    Call Method    ${chrome_options}    add_argument    --no-sandbox
    Call Method    ${chrome_options}    add_argument    --disable-dev-shm-usage
    # 实例化浏览器驱动
    Create Webdriver    Chrome    executable_path=${CHROMEDRIVER_PATH}    chrome_options=${chrome_options}
    # 打开目标URL
    Go To    ${TARGET_URL}
    # 执行下载操作（这里替换成你实际的下载元素定位和点击）
    Click Element    id=download-button
    # 等待下载完成（根据文件大小调整等待时间）
    Sleep    10s
    # 验证文件是否存在
    File Should Exist    ${DOWNLOAD_DIR}/your-file-name.ext
    # 关闭浏览器
    Close Browser

额外注意事项 #

• 确保Jenkins运行用户（比如jenkins用户）对${DOWNLOAD_DIR}有读写权限，可以用chown jenkins:jenkins /var/jenkins_home/downloads命令设置
• 如果是Windows环境，路径要用双反斜杠\\转义，而且要确保Jenkins服务有权限访问该目录
• 可以在Jenkins任务中添加「Execute shell」（或Windows批处理）步骤，提前创建目录并设置权限

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