ChromeDriver更新后Selenium遇NoSuchElementException无法定位元素求助

• ChromeDriver 111.x版本对Polymer类元素（如iron-icon）的Shadow DOM处理逻辑做了调整，原XPATH无法穿透Shadow DOM完成元素定位
• 隐式等待仅设置全局超时，若目标元素处于Shadow DOM内部，即便等待也无法被常规定位方法捕获
• 新版本ChromeDriver默认启用了部分页面隔离策略，可能导致页面渲染结构与旧版本存在差异

1. 适配Shadow DOM定位逻辑 #

如果iron-icon位于父元素的Shadow Root内，需先获取Shadow Root再定位目标元素：

# 定位包含Shadow Root的父元素
parent_element = driver.find_element(By.ID, "icon")
# 获取Shadow Root节点
shadow_root = parent_element.shadow_root
# 在Shadow Root内定位iron-icon元素
download_icon = shadow_root.find_element(By.TAG_NAME, "iron-icon")

2. 替换显式等待提升定位精准度 #

显式等待可针对元素的具体状态（可见、可点击）设置超时，比隐式等待更适配动态页面：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 设置10秒超时，等待元素可见后再定位
download_icon = WebDriverWait(driver, 10).until(
    EC.visibility_of_element_located((By.XPATH, "//*[@id='icon']/iron-icon"))
)

3. 严格匹配Chrome与ChromeDriver版本 #

ChromeDriver 111.0.5563.64对应Chrome浏览器版本必须为111.x，版本不匹配会引发兼容性问题：

• 查看Chrome版本：打开Chrome → 设置 → 关于Chrome
• 若版本不一致，下载对应版本的ChromeDriver替换当前版本

4. 调整Chrome启动参数规避渲染差异 #

新版本ChromeDriver默认启用的部分选项可能影响页面渲染，可添加以下启动参数尝试：

from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# 禁用沙箱模式
chrome_options.add_argument("--no-sandbox")
# 禁用GPU加速
chrome_options.add_argument("--disable-gpu")
# 禁用浏览器扩展
chrome_options.add_argument("--disable-extensions")
# 初始化驱动时传入配置
driver = webdriver.Chrome(options=chrome_options)

5. 重新校验元素实际结构 #

打开Chrome开发者工具的Elements标签，确认元素真实结构：

• 右键目标元素 → 复制 → 复制完整XPATH，替换原脚本中的路径
• 检查元素是否处于iframe内，若是需先切换iframe：driver.switch_to.frame("iframe_id_or_name")

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