在VM上通过Jenkins运行Selenium时屏幕尺寸异常致测试失败求助

我之前也碰到过几乎一模一样的情况！Jenkins通过Java Web Start启动的Windows slave确实经常因为后台会话的限制，导致系统自动降低屏幕分辨率，进而影响Selenium测试的浏览器尺寸。下面是几个亲测有效的解决方法，按优先级排序：

1. 直接在测试代码中强制设置浏览器尺寸 #

这是最快速有效的方案，完全绕过系统分辨率的限制。不管Jenkins slave的环境如何，直接让浏览器启动时就使用你需要的1920x1080分辨率：

针对不同语言/浏览器的示例： #

• Java + 通用Selenium API：

  // 设置固定尺寸（推荐，比最大化更稳定）
  driver.manage().window().setSize(new Dimension(1920, 1080));
  // 也可以尝试最大化（部分环境下可能不如固定尺寸可靠）
  // driver.manage().window().maximize();
  

• Chrome 启动参数：
  在初始化ChromeDriver时添加窗口大小参数，启动时直接生效：

  ChromeOptions options = new ChromeOptions();
  options.addArguments("--window-size=1920,1080");
  // 如果用无头模式，必须加这个参数，否则默认分辨率很小
  options.addArguments("--headless=new");
  WebDriver driver = new ChromeDriver(options);
  

• Firefox 启动参数：

  FirefoxOptions options = new FirefoxOptions();
  options.addArguments("--width", "1920");
  options.addArguments("--height", "1080");
  WebDriver driver = new FirefoxDriver(options);
  

2. 配置Jenkins Slave使用交互式桌面 #

Java Web Start启动的slave默认运行在无桌面的后台会话，系统会自动降低分辨率适配。你可以把Jenkins slave配置成Windows服务，并允许它与桌面交互：

• 打开Windows服务器的「服务管理器」，找到你的Jenkins slave服务
• 右键点击「属性」，切换到「登录」标签页
• 勾选「允许服务与桌面交互」，点击确定后重启服务

这样slave就会运行在有桌面的会话中，系统会使用正常的屏幕分辨率。如果必须用Java Web Start启动，确保启动slave的用户拥有桌面权限，并且不要断开远程桌面会话（或者用VNC工具保持会话活跃）。

3. 验证系统层面的分辨率 #

如果上面的方法都没生效，建议在测试代码开头加一段代码，打印当前系统的屏幕分辨率，确认是不是Jenkins slave的系统分辨率本身就被限制了：

• Java示例：

  Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize();
  System.out.println("当前系统分辨率：" + screenSize.width + "x" + screenSize.height);
  

如果输出确实是1032x776，那你需要调整Windows服务器的显示设置，或者在Jenkins节点配置中添加环境变量来强制系统使用高分辨率。

总结 #

优先尝试强制设置浏览器尺寸，这是代码层面最可控的方案；如果还是不行，再调整Jenkins slave的运行环境，确保它在有桌面交互的会话下运行。旧测试能正常运行就是因为适配了低分辨率，而你的新测试依赖1920x1080，只要让浏览器强制使用这个尺寸就能解决问题。

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