Selenium WebDriverWait未等待elementToBeClickable问题求助

我编写了一个循环点击子菜单项的测试用例，但WebDriver并未等待元素变为可点击状态就抛出异常，直接转而尝试点击下一个子菜单项。预期行为是WebDriver等待元素可点击后再执行点击操作。

ElementFetch类代码 #

public class ElementFetch {
    
    public Actions action;
    
    private WebDriver driver;
    private WebDriverWait wait;
    
    public ElementFetch(WebDriver driver, WebDriverWait wait) {
        this.driver = driver;
        this.wait = wait;
        this.action = new Actions(driver);
    }
    
    public void click(By locator) {
        try {
            WebElement element = wait.withTimeout(Duration.ofSeconds(3)).until(ExpectedConditions.elementToBeClickable(locator));
            action.moveToElement(element).click().build().perform();
        } catch (Exception e) {
            System.err.println("Error clicking the element: " + locator);
        }
    }
    // 省略其他代码
}

BaseTest类代码 #

public class BaseTest {
    public WebDriver driver;
    public WebDriverWait wait;
    public Properties testConfig;
    public ElementFetch elementFetch;
    public Authentication authentication;
    public ModalChecker modalChecker;
    
    private final String configPath = "src\\test\\resources\\config\\config.properties";
    
    @BeforeClass
    public void setUp() throws IOException {
        driver = DriverManager.initializeDriver();
        wait = new WebDriverWait(driver, Duration.ofSeconds(10));
        driver.manage().window().maximize();
        
        testConfig = ConfigurationLoader.loadTestConfig(configPath);
        
        elementFetch = new ElementFetch(driver, wait);
        // 省略其他初始化代码
    }
}

MenuTest类问题代码 #

public class MenuTest extends BaseTest {
    
    private String path = "";
    
    @Test(dataProvider = "dataProviderMainMenu", dataProviderClass = DataProviderClass.class)
    public void testMainMenu(JsonObject menuItem) throws InterruptedException {

        elementFetch.click(By.id(menuItem.get("id").getAsString().replace("\"", "")));
        
        if (menuItem.has("subMenu")) {
            JsonArray subMenuItems = menuItem.getAsJsonArray("subMenu");
            testSubMenu(subMenuItems);
        }
    }
    
    public void testSubMenu(JsonArray subMenuItems) throws InterruptedException {
        for(JsonElement subMenuItem : subMenuItems) {
            JsonObject subMenuItemObject = subMenuItem.getAsJsonObject();

            elementFetch.click(By.id(subMenuItemObject.get("id").getAsString()));
            wait.until(driver -> ((JavascriptExecutor) driver).executeScript("return document.readyState").equals("complete"));
            
            if (subMenuItemObject.has("menu")) {
                JsonArray submenu = subMenuItemObject.get("menu").getAsJsonArray();
                String originalPath = path;
                testSubMenu(submenu);
                path = originalPath;
            }
        }
    }
}

问题原因分析 #

1. 超时时间被强制覆盖：ElementFetch.click()方法中，wait.withTimeout(Duration.ofSeconds(3))会创建新的WebDriverWait实例，把BaseTest中设置的10秒超时替换为3秒，若子菜单加载较慢，很容易触发超时异常。
2. 异常被静默跳过：catch块仅打印错误信息，没有终止测试或重试，导致循环直接进入下一个子菜单项，看起来像是“未等待就跳过”。
3. Actions点击的冗余性：如果子菜单不需要hover触发显示，使用Actions.moveToElement(element).click()反而不如直接调用element.click()稳定，额外的移动操作可能引入不必要的失败。
4. 页面加载等待逻辑不准确：点击后等待document.readyState完成，但子菜单多为前端动态渲染，页面整体readyState完成不代表目标子菜单项已经可点击。

解决方案 #

方案1：修复超时与异常处理逻辑

修改ElementFetch.click()方法，保留原有超时时间，异常时抛出错误而非静默跳过：

public void click(By locator) {
    try {
        // 使用传入的wait实例的原有超时配置，不覆盖
        WebElement element = wait.until(ExpectedConditions.elementToBeClickable(locator));
        // 非hover触发的菜单，直接使用element.click()更可靠
        element.click();
        // 若菜单需要hover展开，再保留Actions逻辑：
        // action.moveToElement(element).click().build().perform();
    } catch (TimeoutException e) {
        // 抛出断言错误，终止当前测试流程
        throw new AssertionError("元素超时未变为可点击状态: " + locator, e);
    } catch (Exception e) {
        System.err.println("点击元素时出错: " + locator);
        throw e; // 重新抛出异常，避免静默跳过
    }
}

方案2：优化子菜单等待逻辑

在循环点击前，先显式等待子菜单项可点击，确保元素状态就绪：

public void testSubMenu(JsonArray subMenuItems) {
    for(JsonElement subMenuItem : subMenuItems) {
        JsonObject subMenuItemObject = subMenuItem.getAsJsonObject();
        By subMenuLocator = By.id(subMenuItemObject.get("id").getAsString());
        
        // 先等待子菜单元素可点击，再执行点击
        wait.until(ExpectedConditions.elementToBeClickable(subMenuLocator));
        elementFetch.click(subMenuLocator);
        
        // 若点击后有页面跳转或内容加载，等待对应目标元素而非仅readyState
        // 示例：wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("target-content")));
        
        if (subMenuItemObject.has("menu")) {
            JsonArray submenu = subMenuItemObject.get("menu").getAsJsonArray();
            String originalPath = path;
            testSubMenu(submenu);
            path = originalPath;
        }
    }
}

方案3：移除不稳定的Thread.sleep

代码中的Thread.sleep()是不可靠的等待方式，建议完全替换为WebDriverWait显式等待，适配不同环境的加载速度差异。

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