Selenium点击Cookie弹窗按钮定位超时问题解决方法

定位失败的核心原因是站点的Cookie授权弹窗基于**Shadow DOM（影子DOM）**实现，Shadow DOM天然具备DOM树隔离特性，常规XPath、CSS选择器无法直接穿透Shadow Root访问内部节点，这也是你在DevTools元素面板搜索不到目标按钮、Selenium持续触发超时的根本原因，和多窗口切换、等待时长不足无关。

前置准备 #

先将Selenium升级到4.6及以上版本，该版本后内置Selenium Manager可自动匹配对应版本的ChromeDriver，无需手动指定驱动路径：

pip install --upgrade selenium

可运行代码 #

定位逻辑调整为先定位Shadow DOM的宿主元素，获取其Shadow Root对象后，再在Shadow Root内部查找目标按钮。注意Shadow Root内优先使用CSS选择器定位，Selenium对Shadow Root下的XPath支持存在缺陷：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC

# 可选：添加反自动化检测参数，避免被站点拦截
chrome_opts = Options()
chrome_opts.add_argument("--disable-blink-features=AutomationControlled")
chrome_opts.add_experimental_option("excludeSwitches", ["enable-automation"])

driver = webdriver.Chrome(options=chrome_opts)
driver.get("https://www.hugoboss.com/uk/men/")

# 等待Cookie弹窗的Shadow宿主节点加载
shadow_host = WebDriverWait(driver, 15).until(
    EC.presence_of_element_located((By.ID, "usercentrics-root"))
)
# 获取Shadow Root实例
shadow_root = shadow_host.shadow_root
# 在Shadow DOM内定位SAVE SERVICES按钮并点击
save_button = WebDriverWait(shadow_root, 10).until(
    EC.element_to_be_clickable((By.CSS_SELECTOR, "button[data-testid='uc-save-button']"))
)
save_button.click()

注意事项 #

• 海外站点静态资源加载速度不稳定，可将WebDriverWait的超时时长适当调整到15-20秒
• 若后续需要操作Cookie弹窗内的其他选项，所有元素都需要从shadow_root对象下发起查找，不能直接用driver对象查找
• 不要在Shadow Root内使用XPath定位，大概率会出现定位失败的问题

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