Linux系统ChromeDriver窗口最大化失效问题求助（Selenium 4.11.0）

问题场景 #

ChromeDriver在Linux系统的无头模式下无法实现窗口最大化，但Windows系统中可正常运行。使用Selenium 4.11.0版本，当前无头模式代码如下：

case "chrome-headless":
            System.setProperty("webdriver.chrome.whitelistedIps", "");
            ChromeOptions chromeOptions = new ChromeOptions()
                    .addArguments("--headless=new")
                    .addArguments("disable-infobars") // disabling infobars
                    .addArguments("--disable-extensions") // disabling extensions
                    .addArguments("--disable-dev-shm-usage") // overcome limited resource problems
                    .addArguments("--no-sandbox") // bypass OS security mode
                    .addArguments("--window-size=1920,1080"); // set size for browser as start-maximized is not working
            driver = new ChromeDriver(chromeOptions);
            logger.debug("Chrome headless driver instance has been created");
            Reporter.log("Chrome headless driver");
            driver.manage().window().maximize();
            break;

失效原因 #

• 无头模式的设计限制：Chrome的--headless=new模式下，driver.manage().window().maximize()方法本身不生效。因为无头环境没有真实的桌面窗口会话，这个方法的调用会被浏览器内核直接忽略。
• Linux与Windows的显示服务差异：Windows系统对无头模式有原生的虚拟桌面支持，--window-size参数能直接生效；而Linux下无头运行依赖虚拟显示服务（如Xvfb），如果环境未正确配置，窗口尺寸的设置可能无法被正确应用。
• 代码冗余冲突：代码中先通过--window-size设置了固定分辨率，之后又调用maximize()方法，这在无头模式下不仅无效，还可能导致预期外的行为（实际是maximize()被忽略，但逻辑上存在冗余）。

解决方案 #

1. 移除无效的maximize()调用
   直接删除driver.manage().window().maximize();这一行，因为在无头模式下这个方法完全不起作用，保留它只会造成混淆。

2. 确认--window-size参数的有效性
   保持--window-size=1920,1080（或你需要的目标分辨率），这是无头模式下设置窗口尺寸的唯一可靠方式。如果需要适配不同的分辨率，可根据场景动态调整这个参数的值。

3. Linux环境配置虚拟显示（可选）
   如果你的Linux服务器没有默认配置虚拟显示服务，安装并启动Xvfb可以确保窗口尺寸被正确渲染：

   # 安装Xvfb（Debian/Ubuntu系）
   sudo apt-get update && sudo apt-get install -y xvfb
   # 启动虚拟显示会话，设置分辨率为1920x1080，颜色深度24位
   Xvfb :99 -screen 0 1920x1080x24 &
   # 设置环境变量，让ChromeDriver使用这个虚拟显示
   export DISPLAY=:99
   

4. 添加窗口尺寸验证
   可以在代码中加入验证逻辑，确认窗口尺寸是否符合预期：

   Dimension currentSize = driver.manage().window().getSize();
   logger.debug("当前窗口尺寸：宽{}px，高{}px", currentSize.getWidth(), currentSize.getHeight());
   

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