如何在Jenkins中调整浏览器窗口大小？Selenium测试尺寸未生效问题

核心原因 #

Jenkins启动参数中包含-Djava.awt.headless=true，该参数让Jenkins运行在AWT无头环境下，系统虚拟屏幕尺寸被限制，导致你在代码中设置的浏览器窗口大小无法生效，最终显示的是无头环境默认的小尺寸(1044, 788)。

解决步骤 #

1. 移除Jenkins的AWT无头启动参数 #

修改Jenkins的启动配置，删除-Djava.awt.headless=true这一项，然后重启Jenkins服务。这是最直接有效的方法，因为该参数会强制限制系统的屏幕渲染尺寸，即使代码中设置浏览器窗口大小也会被覆盖。

2. 修正ChromeOptions的窗口参数格式 #

你代码中window-size=1936, 1048的格式有问题，逗号后不能加空格，正确格式应为window-size=1936,1048。同时建议调整窗口设置的逻辑，避免maximize和setSize的冲突：

if (browser.equalsIgnoreCase("chrome")) {
    ChromeOptions options = new ChromeOptions();
    // 修正window-size参数的格式
    options.addArguments("window-size=1936,1048");
    setDriver(new ChromeDriver(options));

    // 直接设置目标尺寸，无需先最大化再重复设置
    Dimension newSize = new Dimension(1936, 1048);
    getDriver().manage().window().setSize(newSize);

    System.out.println("Current screen size :" + 
    getDriver().manage().window().getSize());
}

3. 可选：若必须保留AWT无头模式（不推荐） #

如果因为某些原因不能移除-Djava.awt.headless=true，可以在Jenkins启动参数中添加虚拟屏幕尺寸的配置：

-Dsun.java2d.dpiaware=false -Dvirtual-screen.width=1936 -Dvirtual-screen.height=1048

添加后重启Jenkins，再运行测试用例验证窗口尺寸是否生效。

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