Selenium4升级后处理嵌套Shadow Root元素出现类型转换错误如何解决

报错根因 #

• Chrome96+Selenium4环境下的ClassCastException：Selenium 4.0开始正式遵循W3C Shadow DOM标准，通过执行JS返回的shadowRoot对象会被自动封装为org.openqa.selenium.remote.ShadowRoot类型，不再兼容旧版本返回WebElement的逻辑，强制类型转换直接触发报错。
• Firefox94环境下的报错：该版本火狐浏览器与对应GeckoDriver对Selenium4的Shadow DOM原生支持存在兼容性缺陷，导致读取shadowRoot时出现节点所属文档为空的错误。

修复方案 #

方案1：采用Selenium4原生Shadow DOM API（推荐） #

直接弃用原有自定义的expandRootElement方法，使用Selenium4内置的getShadowRoot()方法获取阴影根节点，后续查找元素逻辑和原有WebElement操作保持一致：

// 单层阴影根元素获取示例
WebElement shadowHost = driver.findElement(By.cssSelector("your-shadow-host-selector"));
ShadowRoot shadowRoot = shadowHost.getShadowRoot();
WebElement downloadBtn = shadowRoot.findElement(By.cssSelector("your-download-btn-selector"));

// 嵌套阴影根元素获取示例
WebElement firstHost = driver.findElement(By.cssSelector("first-host-selector"));
ShadowRoot firstRoot = firstHost.getShadowRoot();
WebElement secondHost = firstRoot.findElement(By.cssSelector("second-host-selector"));
ShadowRoot secondRoot = secondHost.getShadowRoot();
WebElement targetElement = secondRoot.findElement(By.cssSelector("target-selector"));

方案2：兼容旧代码逻辑 #

如果不想大范围调整原有调用逻辑，可以修改JS执行脚本，直接在JS层面完成阴影根内部的元素查找，不需要返回ShadowRoot对象：

// 通用查找阴影根内部元素的方法
public WebElement findElementInShadow(WebElement shadowHost, String innerCssSelector) {
    JavascriptExecutor jsExecutor = (JavascriptExecutor) driver;
    return (WebElement) jsExecutor.executeScript(
        "return arguments[0].shadowRoot.querySelector(arguments[1])", 
        shadowHost, 
        innerCssSelector
    );
}

Firefox兼容性处理 #

升级火狐浏览器到95及以上版本，同时升级GeckoDriver到0.31.0及以上版本，即可原生支持Selenium4的Shadow DOM API，也可以直接使用方案2的JS查找逻辑绕过兼容性问题。

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