Jenkins配置Robot Framework测试异常：构建不超时及截图关键字执行失败

我来帮你逐一排查并解决这两个在Jenkins中运行Robot Framework测试时遇到的问题：

问题1：失败场景下无法执行Capture Page Screenshot关键字且无超时提示 #

这种情况通常和Jenkins的运行环境权限、浏览器配置或错误处理逻辑有关，推荐以下解决方案：

• 检查目录权限：确保Jenkins执行用户对测试结果目录（比如你指定的results）有读写权限，否则截图无法保存。可以在执行Robot命令前先设置目录权限：

  mkdir -p results && chmod -R 755 results
  

• 优化浏览器无头模式配置：如果是在无头模式下运行浏览器（Jenkins通常用无头模式），旧版本的无头模式可能存在截图兼容性问题。建议更新Chrome的启动参数：

  Open Browser    ${URL}    Chrome    options=add_argument("--headless=new");add_argument("--no-sandbox");add_argument("--disable-gpu")
  

• 强制错误触发与超时设置：在测试用例中用错误处理关键字包裹关键步骤，确保失败时能触发截图；同时给Selenium和Jenkins设置明确超时：
  • 在Robot用例开头添加：Set Selenium Timeout 10s
  • 在Jenkins构建步骤中设置超时（比如Pipeline中用timeout(time: 10, unit: 'MINUTES') { sh 'robot ...' }，自由风格项目可在步骤高级选项中勾选超时）

问题2：Jenkins中Robot测试长时间运行不终止，本地运行正常 #

本地正常但Jenkins卡住，大概率是环境差异或超时配置缺失导致的，试试这些方法：

• 配置Jenkins层级的超时：
  1. 全局层面：在Jenkins「系统管理」→「全局构建超时」中设置默认超时时间（比如30分钟），避免无限制等待。
  2. 步骤层面：给执行Robot的shell步骤单独设置超时，比如在自由风格项目的shell步骤高级选项中填写超时时间，或Pipeline中用timeout指令包裹执行命令。
• 排查测试用例的等待逻辑：本地网络环境可能比Jenkins服务器好，测试中的硬等待（Sleep）或过长的隐式等待可能导致卡住。建议将硬等待替换为智能等待：

  Wait Until Element Is Visible    ${TARGET_ELEMENT}    30s
  

• 验证浏览器驱动兼容性：确保Jenkins服务器上的浏览器驱动（如chromedriver）版本和浏览器版本完全匹配，版本不兼容可能导致浏览器启动后无响应。可以在shell脚本中先打印版本信息排查：

  chromedriver --version
  google-chrome --version
  

• 开启详细日志定位卡点：在Robot命令中添加DEBUG级别的日志输出，方便查看测试卡在哪个步骤：

  robot -d results -L DEBUG -i 1-city-zip-login-change-city tests/simple-test-gateway.robot
  

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