为何Selenium在C#中的显式等待无法正常工作？

问题现象 #

使用WebDriverWait等待目标元素可见时，Trace.WriteLine("aa")完全没有打印，预期应该每隔500ms重复打印，直到元素出现。但解开Thread.Sleep(1000)注释后，功能大多能正常运行。

问题原因 #

页面尚未完成加载时，WebDriverWait就启动了等待逻辑。此时页面可能还处于空白状态，调用ExpectedConditions.ElementIsVisible会直接抛出NoSuchElementException，虽然WebDriverWait默认会捕获这类异常，但在页面未初始化的极端情况下，可能导致轮询逻辑没有按预期重复触发，自然不会执行Trace输出。

修复方案 #

不要依赖Thread.Sleep（这是不稳定的硬等待），改用显式等待页面加载完成，同时自定义元素查找逻辑确保每次轮询都执行Trace：

WebDriverWait wait = new WebDriverWait(new SystemClock(), driver, TimeSpan.FromSeconds(10), TimeSpan.FromMilliseconds(500));
driver.Navigate().GoToUrl("test.com");

// 先等待页面完全加载
wait.Until(driver => ((IJavaScriptExecutor)driver).ExecuteScript("return document.readyState").ToString() == "complete");

// 自定义等待逻辑，确保每次轮询都执行Trace输出
wait.Until(_ =>
{
    Trace.WriteLine("aa");
    try
    {
        var targetElement = driver.FindElement(By.XPath("//button[@data-a-target='change-country-button']"));
        // 返回元素是否可见
        return targetElement.Displayed;
    }
    catch (NoSuchElementException)
    {
        // 元素未找到，继续等待
        return false;
    }
    catch (StaleElementReferenceException)
    {
        // 元素过期（页面刷新导致），继续等待
        return false;
    }
});

方案说明 #

1. 先等待页面document.readyState变为complete，确保页面DOM结构已初始化，避免在空白页面上盲目查找元素。
2. 自定义元素查找并捕获常见异常：每次轮询都会执行Trace输出，同时处理元素未找到、元素过期的情况，让等待逻辑持续执行直到元素可见。

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