Jenkins运行时提取剪贴板文本失败问题求助

问题原因 #

本地运行时系统存在图形界面（X11会话），Toolkit.getDefaultToolkit().getSystemClipboard()可以正常访问系统剪贴板；但Jenkins通常运行在无头环境（无图形界面），未设置X11 DISPLAY变量，导致访问剪贴板的操作触发报错。

修复方案 #

方案1：绕过系统剪贴板，直接从页面提取表格数据（推荐） #

表格内容本身存在于页面DOM中，无需复制到剪贴板再提取，直接通过Selenium定位元素遍历获取数据即可。这种方法不依赖系统环境，跨平台通用且更可靠。

示例代码：

// 定位目标表格（替换为你实际的定位方式，如By.xpath、By.className）
WebElement targetTable = driver.findElement(By.id("table-grid-id"));

StringBuilder tableContent = new StringBuilder();
// 遍历表格所有行
List<WebElement> rows = targetTable.findElements(By.tagName("tr"));
for (WebElement row : rows) {
    // 遍历当前行的所有单元格
    List<WebElement> cells = row.findElements(By.tagName("td"));
    for (int idx = 0; idx < cells.size(); idx++) {
        tableContent.append(cells.get(idx).getText());
        // 模拟剪贴板中单元格的分隔符（通常为制表符）
        if (idx != cells.size() - 1) {
            tableContent.append("\t");
        }
    }
    // 模拟行分隔符（换行）
    tableContent.append("\n");
}

// 最终得到的就是原本要从剪贴板提取的表格数据
String extractedData = tableContent.toString().trim();

方案2：为Jenkins配置虚拟X11显示（适合必须使用剪贴板的场景） #

如果业务逻辑必须依赖剪贴板操作，可以通过Xvfb在Jenkins上创建虚拟图形界面：

• 在Jenkins服务器安装Xvfb工具：Ubuntu系统执行sudo apt-get install xvfb，CentOS系统执行sudo yum install xorg-x11-server-Xvfb
• 安装Jenkins的Xvfb Plugin，在Job配置中启用"Start Xvfb before the build, and shut it down after"，设置DISPLAY变量为:99（默认值）
• 或在构建脚本中手动启动Xvfb：

  # 启动虚拟显示
  Xvfb :99 -ac &
  # 设置DISPLAY变量
  export DISPLAY=:99
  # 运行Selenium测试
  mvn test # 替换为你的实际测试启动命令
  

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