Selenium显式等待等待元素可点击失败问题排查

问题描述 #

使用Selenium显式等待按钮可点击时，即使调用element_to_be_clickable等待条件，仍抛出元素遮挡异常：

self.driver_wait.until(
    expected_conditions.element_to_be_clickable((By.ID, 'login-btn'))
)

异常信息：

selenium.common.exceptions.ElementClickInterceptedException: Message: Element <a id="login-btn" class="fm-btn fm-btn-ghost-white account"> is not clickable at point (886,96) because another element <div id="ot-pc-content" class="ot-pc-scrollbar"> obscures it

尝试等待遮挡元素ot-pc-content不可见，但未解决问题：

self.driver_wait.until(
    expected_conditions.invisibility_of_element((By.ID, 'ot-pc-content'))
)
button_login_1 = self.driver_wait.until(
    expected_conditions.element_to_be_clickable((By.ID, 'login-btn'))
)

复现规律：

• 当cookies_handling(accept_cookies=True, use_fixed_wait=False)且login(use_fixed_wait=False)时，点击失败
• 使用time.sleep或accept_cookies=False时可正常点击

原因分析 #

1. element_to_be_clickable的局限性：该条件仅验证元素是否可见且启用，但不检查元素是否被其他DOM元素遮挡，因此即使条件满足，点击仍可能被拦截。
2. invisibility_of_element的不足：该条件仅检查元素是否视觉隐藏（如display:none或visibility:hidden），但遮挡元素可能仍存在于DOM中，只是视觉上不可见，仍会占据页面空间拦截点击；此外，元素隐藏可能伴随动画，Selenium判定不可见时动画可能未完全结束，元素仍处于可拦截状态。
3. Cookies处理后的状态不稳定：接受所有cookies后，页面可能触发额外的DOM变化或动画（如隐私政策弹窗的关闭动画），现有显式等待未覆盖这些异步过程。

解决方案 #

方案1：等待遮挡元素从DOM中完全移除 #

使用staleness_of条件，等待遮挡元素彻底从DOM中删除，而非仅视觉隐藏：

# 先获取遮挡元素的引用
try:
    overlay_element = self.driver.find_element(By.ID, 'ot-pc-content')
    # 等待元素从DOM中移除
    self.driver_wait.until(expected_conditions.staleness_of(overlay_element))
except:
    # 元素不存在时直接跳过
    pass

方案2：自定义预期条件，验证元素可点击且无遮挡 #

创建自定义等待条件，直接验证元素点击操作不会被拦截：

from selenium.webdriver.support.expected_conditions import ExpectedCondition

class element_is_clickable_and_not_obscured(ExpectedCondition):
    def __init__(self, locator):
        self.locator = locator

    def __call__(self, driver):
        # 先验证元素基础可点击状态
        element = expected_conditions.element_to_be_clickable(self.locator)(driver)
        if element:
            try:
                # 尝试执行点击，若被拦截则抛出异常，条件不满足
                driver.execute_script("arguments[0].click();", element)
                return element
            except Exception:
                return False
        return False

# 使用自定义条件等待按钮
button_login_1 = self.driver_wait.until(element_is_clickable_and_not_obscured((By.ID, 'login-btn')))

方案3：优化Cookies处理后的等待逻辑 #

在cookies_handling方法中，等待隐私弹窗的根容器完全消失，确保页面状态稳定：

def cookies_handling(self, accept_cookies=False, use_fixed_wait=None, wait_time_fixed=None):
    # ... 原有代码 ...
    if accept_cookies:
        button_accept_cookies = self.driver_wait.until(
            expected_conditions.element_to_be_clickable((By.ID, 'onetrust-accept-btn-handler'))
        )
        button_accept_cookies.click()
        # 等待隐私弹窗的根容器消失
        self.driver_wait.until(
            expected_conditions.invisibility_of_element((By.ID, 'onetrust-pc-sdk'))
        )
    # ... 原有代码 ...

方案4：使用JavaScript点击（最后手段） #

如果上述方案都无效，可直接通过JavaScript触发点击，绕过视觉遮挡检查：

button_login_1 = self.driver_wait.until(
    expected_conditions.element_to_be_clickable((By.ID, 'login-btn'))
)
self.driver.execute_script("arguments[0].click();", button_login_1)

修改后的Login方法示例 #

def login(self, email: str, password: str, use_fixed_wait=None, wait_time_fixed=None):
    if not wait_time_fixed:
        wait_time_fixed = self.default_wait_time_fixed
    
    # 等待遮挡元素从DOM中移除
    try:
        overlay_element = self.driver.find_element(By.ID, 'ot-pc-content')
        self.driver_wait.until(expected_conditions.staleness_of(overlay_element))
    except:
        pass
    
    # 使用自定义条件等待按钮可点击且无遮挡
    button_login_1 = self.driver_wait.until(element_is_clickable_and_not_obscured((By.ID, 'login-btn')))
    button_login_1.click()
    
    # ... 后续登录代码 ...

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