Java-Selenium项目在Jenkins(Linux)启动ChromeDriver失败求助

1. 匹配ChromeDriver与Chrome浏览器版本 #

ChromeDriver和Chrome的版本必须严格对应，先检查服务器上的Chrome版本：

google-chrome --version

如果未安装Chrome，根据服务器系统选择安装命令：

• Ubuntu/Debian：

  sudo apt update && sudo apt install -y google-chrome-stable
  

• CentOS/RHEL：

  sudo yum install -y https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
  

下载对应版本的ChromeDriver替换现有文件，确保版本完全匹配。

2. 配置Chrome无头模式与必要参数 #

Linux服务器无图形界面，必须启用无头模式并添加适配Jenkins环境的参数，修改你的Driver初始化代码：

case "chrome":
    System.setProperty("webdriver.chrome.driver", System.getProperty("user.dir")+"/chromedriver" );
    ChromeOptions options = new ChromeOptions();
    // 启用无头模式（新版Chrome推荐参数）
    options.addArguments("--headless=new");
    // 禁用沙箱（Jenkins运行环境必备）
    options.addArguments("--no-sandbox");
    // 解决/dev/shm内存不足问题
    options.addArguments("--disable-dev-shm-usage");
    // 固定窗口大小，避免元素定位异常
    options.addArguments("--window-size=1920,1080");
    driver = new ChromeDriver(options);
    break;

3. 优化Jenkins执行脚本 #

• 改用相对路径设置ChromeDriver权限，避免硬编码路径：

  chmod +x ./chromedriver
  

• 确保Jenkins用户拥有项目目录的完整权限：

  sudo chown -R jenkins:jenkins /home/jenkins/workspace/Website-Automation
  

4. 检查并补全系统依赖 #

Chrome运行可能缺失底层依赖，根据日志提示安装对应库：

• Ubuntu/Debian：

  sudo apt install -y libxss1 libappindicator1 libindicator7
  

• CentOS/RHEL：

  sudo yum install -y libXScrnSaver libappindicator-gtk3
  

5. 启用详细日志排查问题 #

在代码中添加ChromeDriver日志配置，定位具体启动失败原因：

System.setProperty("webdriver.chrome.logfile", "./chromedriver.log");
System.setProperty("webdriver.chrome.verboseLogging", "true");

查看生成的chromedriver.log文件，获取更精准的错误信息。

内容的提问来源于stack exchange，提问作者MESUT ÖZÜDOĞRU