如何在GitLab CI中最大化浏览器运行Selenium Java测试？

你的测试在GitLab Runner的VM环境中运行时，即使配置了--start-maximized仍以无头模式执行，核心原因是VM默认无图形界面环境，Chrome会自动切换到无头模式，或者存在隐性的无头配置。以下是具体排查和解决步骤：

1. 排查隐性无头参数 #

检查测试框架、Maven配置（pom.xml）、GitLab流水线变量中是否存在强制无头的配置：

• 比如系统属性webdriver.chrome.headless=true，或者ChromeOptions里被其他代码添加了--headless参数。
• 可以在启动ChromeDriver前打印当前生效的参数，确认配置：

// 在初始化driver前添加
System.out.println("当前Chrome生效参数: " + options.getArguments());

2. 为VM配置虚拟桌面（Xvfb） #

GitLab Runner的VM通常无桌面环境，需要用Xvfb模拟图形界面来运行非无头浏览器：

Linux环境流水线配置 #

在script阶段添加Xvfb安装和启动命令：

script:
  - apt-get update && apt-get install -y xvfb
  - Xvfb :99 -ac &  # 启动虚拟显示
  - export DISPLAY=:99  # 告诉Chrome使用虚拟显示
  - cd pth/to/my/framework/src/runner/file
  - mvn test

Windows环境配置 #

确保GitLab Runner服务以有桌面权限的本地用户启动，并且开启自动登录（Windows GUI需要用户会话才能运行）。

3. 显式禁用无头模式 #

在ChromeOptions中添加参数强制关闭无头模式，避免Chrome在无DISPLAY环境下自动切换：

ChromeOptions options = new ChromeOptions();
options.addArguments("--start-maximized");
options.addArguments("--no-headless"); // 显式禁用无头
options.setExperimentalOption("prefs", prefs);
driver = new ChromeDriver(options);

4. 验证浏览器与驱动版本兼容性 #

ChromeDriver和Chrome版本不匹配会导致参数失效，可在流水线中添加版本检查命令：

script:
  - google-chrome --version
  - chromedriver --version
  # 后续测试命令...

确保两者版本完全对应（比如Chrome 114对应ChromeDriver 114.x）。

5. 检查GitLab Runner执行器模式 #

• 如果用shell执行器：Linux下确保Runner用户有X权限，Windows下不能用系统账户启动Runner服务。
• 如果用docker执行器：使用带桌面环境的镜像（比如selenium/standalone-chrome），或者在容器内配置Xvfb。

内容的提问来源于stack exchange，提问作者Amad Bin Mumtaz