Selenium无法识别Angular+React站点模态框 如何实现关闭操作

核心错误原因 #

• 你使用的find_element_by_class_name是Selenium 3已弃用的API，Selenium 4+不再默认支持，优先使用find_element(By.xxx, 定位符)写法
• 模态框属于页面加载完成后异步渲染的动态元素，你仅等待了页面标题加载完成，没有预留模态框弹出的渲染时间
• 该站点使用React/Angular开发，模态框大概率封装在Shadow DOM或独立<iframe>中，普通DOM查找逻辑无法穿透这两类容器
• modal可能是复合类名的其中一段，find_element_by_class_name仅支持匹配单个完整类名，无法识别多类名组合中的片段

调整方案 #

1. 优先使用显式等待匹配模态框 #

先等待模态框元素渲染完成再执行后续操作，避免提前查找导致的匹配失败。

2. 检查是否嵌套在iframe中 #

打开浏览器控制台的元素面板，搜索模态框元素后向上回溯父节点，如果存在<iframe>标签，需要先切换到对应iframe再查找元素。

3. 适配Shadow DOM查找逻辑 #

如果模态框在Shadow DOM容器内，需要先获取Shadow Root节点，再在根节点下查找子元素。

4. 使用CSS选择器替代类名查找 #

支持模糊匹配类名字段，避免复合类名导致的匹配失败。

修改后可运行代码示例 #

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import NoSuchElementException, TimeoutException

option = webdriver.ChromeOptions()
option.add_argument('--disable-blink-features=AutomationControlled')
option.add_argument("start-maximized")
option.add_experimental_option(
    "excludeSwitches", ["enable-automation"])
prefs = {"credentials_enable_service": False,
     "profile.password_manager_enabled": False,
     "useAutomationExtension": False}
option.add_experimental_option("prefs", prefs)

driver = webdriver.Chrome(options=option)
wait = WebDriverWait(driver, 20)
driver.maximize_window()

# 登录逻辑省略
wait.until(EC.title_contains('Home'))

try:
    # 等待模态框最长10秒，适配延迟弹出场景，用CSS选择器模糊匹配含modal类的元素
    modal = wait.until(EC.presence_of_element_located((By.CSS_SELECTOR, 'div[class*="modal"]')), timeout=10)
    print("Modal Found")
    # 关闭模态框：可根据实际关闭按钮的定位符修改
    modal.find_element(By.CSS_SELECTOR, 'button[aria-label*="关闭"], button.close').click()
except TimeoutException:
    # 检查是否存在iframe
    iframes = driver.find_elements(By.TAG_NAME, 'iframe')
    for iframe in iframes:
        driver.switch_to.frame(iframe)
        try:
            modal = driver.find_element(By.CSS_SELECTOR, 'div[class*="modal"]')
            print("Modal Found in iframe")
            modal.find_element(By.CSS_SELECTOR, 'button[aria-label*="关闭"], button.close').click()
            driver.switch_to.default_content()
            break
        except NoSuchElementException:
            driver.switch_to.default_content()
            continue
    # 如果iframe也没找到，检查Shadow DOM场景
    else:
        shadow_hosts = driver.find_elements(By.CSS_SELECTOR, '*')
        for host in shadow_hosts:
            try:
                shadow_root = host.shadow_root
                modal = shadow_root.find_element(By.CSS_SELECTOR, 'div[class*="modal"]')
                print("Modal Found in Shadow DOM")
                shadow_root.find_element(By.CSS_SELECTOR, 'button[aria-label*="关闭"], button.close').click()
                break
            except:
                continue
        else:
            print("Modal not found")

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