我明白你在Linux环境跑自动化测试时，全页截图遇到的麻烦了——那三段代码都只能抓到浏览器可见区域，确实头疼。咱们先拆解下每段代码为啥不行，再给你针对性的解决办法：

先分析现有代码的问题 #

• Code 1：scenario.embed(sharedDriver.getScreenshotAs(OutputType.BYTES), "image/png");
  Selenium原生的getScreenshotAs方法本身就只支持截取当前浏览器视口（可见区域），不管什么系统，它都没有全页截图的能力，所以这个方法从根源上就没法满足需求。

• Code 2：基于Robot类的屏幕截图
  Robot是用来抓取整个系统屏幕的工具，但在Linux环境下，它严重依赖完整的GUI桌面环境。如果你的测试是在无头模式（比如headless Chrome/Firefox）下运行，或者服务器没有配置X Window这类显示服务，Robot根本无法正常工作。而且就算能运行，它截的是整个屏幕，不是浏览器专属的全页内容，一旦浏览器窗口没最大化或被遮挡，结果完全不符合预期。

• Code 3：基于AShot库的实现
  AShot的ViewportPastingStrategy原本是通过拼接多次视口截图实现全页，但在Linux无头环境下，可能存在两个问题：一是浏览器视口高度的计算异常，导致拼接逻辑失效；二是AShot对现代无头浏览器的兼容性不足，滚动或截图拼接的逻辑跟不上浏览器的行为。

推荐的解决方案 #

方案1：使用浏览器原生全页截图API（最稳定） #

现代Chrome和Firefox都支持通过DevTools命令实现原生全页截图，无需额外依赖，且在Linux无头模式下表现稳定，是首选方案。

Chrome实现示例：

// 配置无头Chrome参数
ChromeOptions options = new ChromeOptions();
options.addArguments("--headless=new"); // 新版无头模式，更接近真实浏览器
options.addArguments("--start-maximized");
WebDriver driver = new ChromeDriver(options);

// 调用Chrome DevTools的截图命令，指定full为true实现全页截图
Map<String, Object> params = new HashMap<>();
params.put("format", "png");
params.put("full", true);
Object result = ((ChromeDriver) driver).executeCdpCommand("Page.captureScreenshot", params);

// 解析Base64编码的截图数据并嵌入scenario
byte[] screenshotBytes = Base64.getDecoder().decode((String) ((Map) result).get("data"));
scenario.embed(screenshotBytes, "image/png");

Firefox实现示例：

// 配置无头Firefox参数
FirefoxOptions options = new FirefoxOptions();
options.addArguments("--headless");
options.addArguments("--start-maximized");
WebDriver driver = new FirefoxDriver(options);

// 使用Firefox专属的全页截图工具
FirefoxFullPageScreenshot screenshot = new FirefoxFullPageScreenshot(driver, new File("fullpage.png"));
screenshot.takeScreenshot();

// 将截图文件转为字节数组嵌入scenario
byte[] screenshotBytes = FileUtils.readFileToByteArray(new File("fullpage.png"));
scenario.embed(screenshotBytes, "image/png");

方案2：修复AShot的使用逻辑（备选） #

如果一定要用AShot，需要针对Linux无头环境调整参数，确保滚动和拼接逻辑正常：

// 先强制设置浏览器窗口大小，避免无头模式默认窗口过小
sharedDriver.manage().window().setSize(new Dimension(1920, 1080));

// 调整AShot的滚动和拼接策略，增加等待时间确保页面加载完成
Screenshot screenshot = new AShot()
        .shootingStrategy(ShootingStrategies.viewportPasting(1000)) // 延长拼接等待时间
        .scrollIntoViewStrategy(ScrollIntoViewStrategies.bottom()) // 确保滚动到页面最底部
        .takeScreenshot(sharedDriver);

File file = new File("screenshot.png");
ImageIO.write(screenshot.getImage(), "png", file);
scenario.embed(FileUtils.readFileToByteArray(file), "image/png");

方案3：适配Linux GUI环境（不推荐） #

如果坚持用Robot类，需要确保Linux机器配置了完整的桌面环境，并且测试在虚拟显示会话中运行（比如用Xvfb模拟显示）。但这种方式复杂度高，且截图容易受系统其他窗口干扰，不建议采用。

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