为何使用WebDriverWait未找到元素时不抛出NoSuchElementException？

原因分析 #

WebDriverWait的until()方法默认会忽略NoSuchElementException和StaleElementReferenceException，所以即使目标元素不存在，等待过程中不会抛出该异常，只会在等待超时后抛出TimeoutException——这就是你代码里捕获不到NoSuchElementException的核心原因。

解决方案 #

如果你需要同时实现等待元素可见的功能，并且在元素确实不存在时处理对应异常，可以通过以下两种方式实现：

方式一：超时后二次验证元素状态（推荐） #

当等待超时后，主动检查元素是否存在，以此区分是“元素存在但未及时可见”还是“元素根本不存在”：

import time
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as ec
from selenium.common.exceptions import NoSuchElementException, TimeoutException
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

options = webdriver.ChromeOptions()
options.add_argument("start-maximized")
s = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=s, options=options)
driver.get(r"https://www.google.com/")
invalid_xpath = "//h2"

time.sleep(2)

try:
    element = WebDriverWait(driver, 20).until(ec.visibility_of_element_located((By.XPATH, invalid_xpath)))
except TimeoutException:
    # 超时后检查元素是否存在
    try:
        driver.find_element(By.XPATH, invalid_xpath)
        print("元素存在但未在指定时间内可见")
    except NoSuchElementException:
        print("No such element exception occurs")
except Exception as e:
    print(f"其他异常：{str(e)}")

方式二：自定义等待逻辑 #

自己实现等待循环，既等待元素可见，又能在元素不存在时直接抛出异常（不推荐，频繁查询会影响性能）：

import time
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException, TimeoutException
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

options = webdriver.ChromeOptions()
options.add_argument("start-maximized")
s = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=s, options=options)
driver.get(r"https://www.google.com/")
invalid_xpath = "//h2"

time.sleep(2)

def wait_for_element_visible(driver, locator, timeout=20):
    end_time = time.time() + timeout
    while time.time() < end_time:
        try:
            element = driver.find_element(*locator)
            if element.is_displayed():
                return element
        except NoSuchElementException:
            # 元素不存在时直接抛出异常
            raise
        time.sleep(0.5)
    raise TimeoutException("元素未在指定时间内可见")

try:
    element = wait_for_element_visible(driver, (By.XPATH, invalid_xpath), 20)
except NoSuchElementException:
    print("No such element exception occurs")
except TimeoutException:
    print("Timeout exception occurs")

注意事项 #

• 不要随意修改WebDriverWait的ignored_exceptions参数，这会破坏默认的等待重试机制，导致等待过程中一旦出现NoSuchElementException就立刻终止，无法实现“等待元素可见”的核心需求。

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