Selenium操作Shadow DOM出现ClassCastException错误，求解决方案

你遇到的ClassCastException是因为**shadowRoot返回的是ShadowRoot类型对象，而非WebElement**，两者属于不同的类，无法直接强制转换。代码中第25行(WebElement) js.executeScript("return arguments[0].shadowRoot", root_ShadowHost)的强制转换是错误的根源。

方案1：使用Selenium 4+原生Shadow DOM API（推荐） #

Selenium 4及以上版本已原生支持Shadow DOM操作，无需借助JavascriptExecutor，代码更简洁且类型安全：

修改后的完整代码：

package practice;

import java.util.concurrent.TimeUnit;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;

public class ShadowDomExample {

    @SuppressWarnings("deprecation")
    public static void main(String[] args) throws InterruptedException {
        WebDriver driver = new ChromeDriver();
        driver.manage().timeouts().implicitlyWait(20, TimeUnit.SECONDS);

        driver.get("https://books-pwakit.appspot.com/");
        driver.manage().window().maximize();

        // 获取Shadow Host元素
        WebElement rootShadowHost = driver.findElement(By.cssSelector("book-app[apptitle='BOOKS']"));
        // 用原生方法获取ShadowRoot
        org.openqa.selenium.SearchContext shadowRoot = rootShadowHost.getShadowRoot();

        // 在ShadowRoot内部逐层查找元素
        WebElement appHeader = shadowRoot.findElement(By.tagName("app-header"));
        WebElement appToolbar = appHeader.findElement(By.cssSelector("app-toolbar.toolbar-bottom"));
        WebElement bookInputDecorator = appToolbar.findElement(By.tagName("book-input-decorator"));

        // 定位搜索输入框并输入内容
        WebElement searchBox = bookInputDecorator.findElement(By.cssSelector("input[aria-label='Search Books']"));
        searchBox.sendKeys("Testing");

        System.out.println("成功在搜索框输入内容");
        driver.quit();
    }
}

方案2：保留JavascriptExecutor但修正类型转换 #

如果仍需使用JavascriptExecutor，不要将shadowRoot强制转为WebElement，而是转为SearchContext（ShadowRoot实现了该接口，支持元素查找）：

修改关键代码段：

JavascriptExecutor js = (JavascriptExecutor) driver;
// 转换为SearchContext而非WebElement
org.openqa.selenium.SearchContext shadowDOM = (org.openqa.selenium.SearchContext) js.executeScript("return arguments[0].shadowRoot", root_ShadowHost);

// 后续元素查找逻辑保持不变
WebElement appheader = shadowDOM.findElement(By.tagName("app-header"));

核心说明 #

• ShadowRoot类实现了SearchContext接口，因此可以调用findElement()方法查找内部元素，但它并非WebElement的子类，所以不能强制转换。
• Selenium 4原生的getShadowRoot()方法是官方推荐方案，避免了JS执行带来的类型转换问题，代码可读性与稳定性更高。

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