Selenium中ElementClickInterceptedException无拦截提示的原因及解决

一、先修复Cucumber @After钩子提前销毁Driver的问题 #

这是导致显式等待被忽略、click日志不打印的核心原因：

• 确保@After钩子仅在当前线程所有测试步骤完全执行完毕后，再调用threadLocalDriver.remove()。可以通过线程安全的执行状态标记，或者调整钩子执行优先级来实现。
• 示例调整代码：

private static final ThreadLocal<Boolean> testCompleted = ThreadLocal.withInitial(() -> false);

// 在测试步骤全部完成后调用此方法标记状态
public void markTestCompleted() {
    testCompleted.set(true);
}

@After(order = 100) // 设置更低执行顺序，保证其他后置操作先完成
public void tearDown() {
    // 等待测试完成（添加超时避免死等）
    int waitCount = 0;
    while (!testCompleted.get() && waitCount < 120) { // 最多等待60秒
        try {
            Thread.sleep(500);
            waitCount++;
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            break;
        }
    }
    threadLocalDriver.remove();
    testCompleted.remove();
}

二、优化元素点击的等待逻辑，处理窗口遮挡场景 #

针对无WebElement重叠的遮挡（如系统弹窗、浏览器窗口层级问题），扩展等待条件：

1. 自定义组合等待条件 #

public void click(WebElement webElement) {
    System.out.println("starting click on thread: " + Thread.currentThread().getName());
    WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(waitTimer));
    
    wait.until(driver -> {
        // 校验元素可点击
        if (!ExpectedConditions.elementToBeClickable(webElement).apply(driver)) {
            return false;
        }
        // 校验元素在可视窗口内，不在则滚动至视图中心
        JavascriptExecutor js = (JavascriptExecutor) driver;
        boolean isInView = (boolean) js.executeScript(
                "var rect = arguments[0].getBoundingClientRect();" +
                "return rect.top >= 0 && rect.left >= 0 && rect.bottom <= window.innerHeight && rect.right <= window.innerWidth;",
                webElement);
        if (!isInView) {
            js.executeScript("arguments[0].scrollIntoView({block: 'center'});", webElement);
            return false;
        }
        // 尝试点击，捕获遮挡异常后重试
        try {
            webElement.click();
            return true;
        } catch (ElementClickInterceptedException e) {
            // 无元素重叠提示，短暂等待后重试
            try {
                Thread.sleep(1000);
            } catch (InterruptedException ie) {
                Thread.currentThread().interrupt();
            }
            return false;
        }
    });
    
    System.out.println("ending click on thread: " + Thread.currentThread().getName());
}

2. 兜底方案：JavaScript点击 #

如果确认是窗口层级遮挡而非页面元素交互问题，可使用JS点击绕过限制：

wait.until(ExpectedConditions.visibilityOf(webElement));
((JavascriptExecutor) driver).executeScript("arguments[0].click();", webElement);

注意：JS点击会跳过页面交互校验，仅作为异常场景的兜底，优先保证正常点击逻辑。

三、多线程环境额外优化 #

• 调整并行线程数：根据机器性能和页面加载速度，将线程数从10+降至6-8，减少页面加载压力。
• 增加页面加载完成等待：在页面跳转后，等待文档加载完成：

wait.until(driver -> ((JavascriptExecutor) driver).executeScript("return document.readyState").equals("complete"));

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