Firefox Headless模式下Selenium截图失败问题求助

• 指定明确的窗口尺寸
  无头模式下Firefox默认窗口尺寸可能不符合预期，导致截图异常。初始化WebDriver时显式设置窗口大小：

  driver.manage().window().setSize(new Dimension(1920, 1080));
  

  或者通过FirefoxOptions配置启动参数：

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

• 匹配Firefox与GeckoDriver版本
  版本不兼容是无头模式功能异常的常见原因，确保GeckoDriver版本与你的Firefox浏览器版本严格对应（比如Firefox 115+对应GeckoDriver 0.33.0+）。

• 使用Firefox原生截图逻辑替代TakeScreenshot
  绕过Selenium的TakeScreenshot限制，先调整窗口适配页面实际尺寸，再执行截图：

  // 获取页面完整宽高
  Long width = (Long) driver.executeScript("return document.documentElement.scrollWidth");
  Long height = (Long) driver.executeScript("return document.documentElement.scrollHeight");
  // 调整窗口为页面尺寸
  driver.manage().window().setSize(new Dimension(width.intValue(), height.intValue()));
  // 执行截图
  File screenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
  

• 切换新版无头模式并调整偏好
  旧版--headless参数存在功能限制，改用新版无头模式并禁用GPU加速避免渲染问题：

  FirefoxOptions options = new FirefoxOptions();
  options.addArguments("--headless=new");
  options.addPreference("layers.acceleration.disabled", true);
  options.addPreference("gfx.webrender.enabled", false);
  

• 确保页面完全加载后截图
  添加显式等待，避免因页面未加载完成导致截图空白：

  WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
  wait.until(ExpectedConditions.presenceOfElementLocated(By.tagName("body")));
  

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