Selenium 4：使用RemoteWebDriver无法处理HasAuthentication认证弹窗求助

本地用ChromeDriver实例处理Basic认证弹窗时正常，但切换到CI环境的RemoteWebDriver时，抛出如下异常：

INFO: Using OpenTelemetry for tracing
Aug 05, 2022 3:44:56 PM org.openqa.selenium.remote.ProtocolHandshake createSession
INFO: Detected upstream dialect: W3C
Exception in thread "main" java.lang.ClassCastException: org.openqa.selenium.remote.RemoteWebDriver cannot be cast to org.openqa.selenium.HasAuthentication
at domain.TestWithRemoteDriver.main(TestWithRemoteDriver.java:47)

原因是RemoteWebDriver默认不实现HasAuthentication接口，无法直接通过强制转换调用register方法。以下是三种可行的解决方案：

方案1：URL嵌入凭证（最简便通用） #

直接将用户名和密码嵌入目标URL，浏览器会自动完成Basic认证，无需调用HasAuthentication相关方法。

修改后的代码：

public class TestWithRemoteDriver {
    public static void main(String[] args) throws MalformedURLException {
        Boolean isGridEnable = true;
        WebDriver webDriver;
        if (isGridEnable) {
            ChromeOptions chromeOptions = getChromeDesiredCapabilities();
            String seleniumRemoteUrl = "http://localhost:4444/wd/hub";
            webDriver = new RemoteWebDriver(new URL(seleniumRemoteUrl), chromeOptions);
        } else {
            WebDriverManager.getInstance(DriverManagerType.CHROME).setup();
            webDriver = new ChromeDriver();
        }
        // URL中直接嵌入用户名和密码
        webDriver.get("https://admin:admin@the-internet.herokuapp.com/basic_auth");
        String success = webDriver.findElement(By.xpath("//*[@id=\"content\"]/div/p")).getText();
        System.out.println(success);
        webDriver.quit();
    }
    private static ChromeOptions getChromeDesiredCapabilities() {
        ChromeOptions chromeOptions = new ChromeOptions();
        HashMap<String, Object> chromePrefs = new HashMap<>();
        chromeOptions.addArguments("--start-fullscreen");
        chromeOptions.addArguments("--window-size=1920,1080");
        chromeOptions.addArguments("--start-maximized");
        chromeOptions.addArguments("--disable-gpu");
        chromeOptions.setExperimentalOption("prefs", chromePrefs);
        return chromeOptions;
    }
}

方案2：通过CDP命令设置认证（Chrome/Edge专属） #

利用Chrome DevTools Protocol（CDP）命令，直接向RemoteWebDriver注入认证信息，替代HasAuthentication的功能。

修改后的代码：

import java.util.Map;

public class TestWithRemoteDriver {
    public static void main(String[] args) throws MalformedURLException {
        Boolean isGridEnable = true;
        WebDriver webDriver;
        if (isGridEnable) {
            ChromeOptions chromeOptions = getChromeDesiredCapabilities();
            String seleniumRemoteUrl = "http://localhost:4444/wd/hub";
            webDriver = new RemoteWebDriver(new URL(seleniumRemoteUrl), chromeOptions);
        } else {
            WebDriverManager.getInstance(DriverManagerType.CHROME).setup();
            webDriver = new ChromeDriver();
        }
        // 执行CDP命令设置Basic认证
        if (webDriver instanceof RemoteWebDriver) {
            ((RemoteWebDriver) webDriver).executeCdpCommand("Network.setAuthCredentials", Map.of(
                "origin", "https://the-internet.herokuapp.com",
                "username", "admin",
                "password", "admin"
            ));
        }
        webDriver.get("https://the-internet.herokuapp.com/basic_auth");
        String success = webDriver.findElement(By.xpath("//*[@id=\"content\"]/div/p")).getText();
        System.out.println(success);
        webDriver.quit();
    }
    private static ChromeOptions getChromeDesiredCapabilities() {
        ChromeOptions chromeOptions = new ChromeOptions();
        HashMap<String, Object> chromePrefs = new HashMap<>();
        chromeOptions.addArguments("--start-fullscreen");
        chromeOptions.addArguments("--window-size=1920,1080");
        chromeOptions.addArguments("--start-maximized");
        chromeOptions.addArguments("--disable-gpu");
        chromeOptions.setExperimentalOption("prefs", chromePrefs);
        return chromeOptions;
    }
}

方案3：用Augmenter增强RemoteWebDriver（Selenium 4+） #

如果你的Selenium Grid版本为4.x，可以通过Augmenter工具增强RemoteWebDriver，使其支持HasAuthentication接口。

修改后的代码：

import org.openqa.selenium.remote.Augmenter;

public class TestWithRemoteDriver {
    public static void main(String[] args) throws MalformedURLException {
        Boolean isGridEnable = true;
        WebDriver webDriver;
        if (isGridEnable) {
            ChromeOptions chromeOptions = getChromeDesiredCapabilities();
            String seleniumRemoteUrl = "http://localhost:4444/wd/hub";
            webDriver = new RemoteWebDriver(new URL(seleniumRemoteUrl), chromeOptions);
            // 增强RemoteWebDriver以支持HasAuthentication
            webDriver = new Augmenter().augment(webDriver);
        } else {
            WebDriverManager.getInstance(DriverManagerType.CHROME).setup();
            webDriver = new ChromeDriver();
        }
        ((HasAuthentication) webDriver).register(UsernameAndPassword.of("admin", "admin"));
        webDriver.get("https://the-internet.herokuapp.com/basic_auth");
        String success = webDriver.findElement(By.xpath("//*[@id=\"content\"]/div/p")).getText();
        System.out.println(success);
        webDriver.quit();
    }
    private static ChromeOptions getChromeDesiredCapabilities() {
        ChromeOptions chromeOptions = new ChromeOptions();
        HashMap<String, Object> chromePrefs = new HashMap<>();
        chromeOptions.addArguments("--start-fullscreen");
        chromeOptions.addArguments("--window-size=1920,1080");
        chromeOptions.addArguments("--start-maximized");
        chromeOptions.addArguments("--disable-gpu");
        chromeOptions.setExperimentalOption("prefs", chromePrefs);
        return chromeOptions;
    }
}

注意事项 #

• 方案1是通用方案，支持所有浏览器，但部分现代浏览器可能会默认阻止URL嵌入凭证（需确认浏览器安全设置）。
• 方案2仅适用于Chrome、Edge等支持CDP协议的浏览器。
• 方案3要求Selenium Grid及节点驱动版本均为4.x以上，确保兼容性。

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