如何征服 Selenium 在无头模式下的「无头环境」错误？

2024-03-21 20:39:16

## 征服 Selenium 在无头模式下的"无头环境"错误

### 引言

在自动化测试的领域，Selenium Webdriver 无疑是颇受青睐的工具。它强大的功能和易用性使测试人员能够轻松执行各种测试用例。然而，在使用 Selenium 进行无头模式测试时，"java.awt.AWTException：无头环境" 错误却是一个常见的绊脚石。

### 错误的根源

此错误的根本原因在于尝试在无头模式下执行需要图形用户界面 (GUI) 的操作。当 Selenium 在无头模式下运行时，它没有 GUI，因此无法执行某些操作，例如鼠标悬停、滚动或截屏。

### 解决方案

要解决此错误，有几种方法可以采用：

1. 禁用图像显示：

在创建 Chrome 选项时，添加 --disable-features=VizDisplayCompositor 参数，以禁用图像显示。

2. 使用模拟点击：

如果需要执行单击操作，请使用 JavaScript 执行器模拟点击，而不是使用鼠标操作。

3. 检查依赖关系：

确保你的项目中包含所有必需的依赖关系，包括 Selenium Webdriver 和 JUnit。

4. 更新 Selenium Webdriver：

尝试更新到 Selenium Webdriver 的最新版本。

5. 重新启动浏览器：

在每次测试用例之前关闭并重新启动浏览器，以确保处于干净的状态。

### 代码示例

以下是一个使用上面建议的解决方案更新后的 Chrome 选项类示例：

import org.openqa.selenium.chrome.ChromeOptions;

public class CustomChromeOptions {

    public static ChromeOptions getOptions() {
        ChromeOptions chromeOptions = new ChromeOptions();
        chromeOptions.addArguments("--disable-extensions");
        chromeOptions.addArguments("--enable-application-cache");
        chromeOptions.addArguments("--allow-running-insecure-content");
        chromeOptions.addArguments("--no-sandbox");
        chromeOptions.addArguments("--enable-automation");
        chromeOptions.addArguments("--ignore-certificate-errors");
        chromeOptions.addArguments("--remote-allow-origins=*");
        chromeOptions.addArguments("--disable-dev-shm-usage");
        chromeOptions.addArguments("--disable-gpu");
        chromeOptions.addArguments("--remote-debugging-port=3222");
        chromeOptions.addArguments("--disable-infobars");
        chromeOptions.addArguments("--disable-features=VizDisplayCompositor");

        String incognito = System.getProperty("incognito", "false");
        if (incognito.equalsIgnoreCase("true")) {
            chromeOptions.addArguments("--incognito");
        }

        String pathToDownl = System.getProperty("user.home") + "\\" + Constants.$string("download.location");
        HashMap<String, Object> chromePre = new HashMap<String, Object>();
        chromePre.put("profile.default_content_settings.popups", 0);
        chromePre.put("download.prompt_for_download", false);
        chromePre.put("download.default_directory", pathToDownl);
        chromePre.put("profile.content_settings.exceptions.automatic_downloads.*.setting", 1);
        chromePre.put("safebrowsing.enabled", false);
        chromeOptions.setExperimentalOption("prefs", chromePre);

        if ($boolean("enableProxy")==true){
            chromeOptions.setCapability("proxy", setProxy());
        }

        return chromeOptions;
    }
}