C# Selenium报'ExpectedConditions'不存在错误如何解决

出现CS0234编译错误、提示当前上下文中不存在ExpectedConditions，核心原因是Selenium 3.11及更高版本中，ExpectedConditions类已经从OpenQA.Selenium.Support.UI命名空间下移除，不再包含在Selenium.WebDriver和Selenium.Support这两个核心NuGet包中，仅靠原有程序集引用自然找不到对应类型。
报错完整中文释义：

错误 CS0234：命名空间"OpenQA.Selenium.Support.UI"中不存在类型或命名空间名"ExpectedConditions"（是否缺少程序集引用？）

两种方案二选一即可，优先推荐方案1，改造成本最低。

方案1：安装官方拆分的独立等待辅助包 #

• 在项目中打开NuGet包管理器，搜索安装SeleniumExtras.WaitHelpers包，这是Selenium官方维护的、从原有支持库中拆分出来的等待条件扩展包
• 在代码文件顶部引入对应命名空间：

using SeleniumExtras.WaitHelpers;

• 原有等待逻辑不需要做任何修改，直接就能正常运行，完整代码如下：

public void WaitForElementLoad(By by, int timeoutInSeconds)
{
    if (timeoutInSeconds > 0)
    {
        WebDriverWait wait = new WebDriverWait(WebDriver, TimeSpan.FromSeconds(timeoutInSeconds));
        wait.Until(ExpectedConditions.ElementIsVisible(by));
    }
}

这个包内的ExpectedConditions类API和之前完全兼容，不需要调整业务侧的等待逻辑。

方案2：自定义等待逻辑，零额外依赖 #

如果不想额外引入NuGet包，可以直接给WebDriverWait.Until方法传入判断委托，自己实现元素可见的校验逻辑，不需要依赖ExpectedConditions类，代码如下：

public void WaitForElementLoad(By by, int timeoutInSeconds)
{
    if (timeoutInSeconds > 0)
    {
        WebDriverWait wait = new WebDriverWait(WebDriver, TimeSpan.FromSeconds(timeoutInSeconds));
        wait.Until(d =>
        {
            try
            {
                var ele = d.FindElement(by);
                return ele.Displayed;
            }
            catch (NoSuchElementException)
            {
                // 元素还没加载到DOM里，继续等待
                return false;
            }
            catch (StaleElementReferenceException)
            {
                // 元素加载后又被移除/刷新，继续等待
                return false;
            }
        });
    }
}

这段逻辑和官方ElementIsVisible的判断规则完全一致：按配置的时间间隔轮询页面，直到找到目标元素且元素处于可见状态，超出设置的超时时间就抛出等待超时异常。

• 不要为了找回ExpectedConditions刻意降级Selenium核心包版本，低版本Selenium对新版Chrome、Edge等浏览器存在大量兼容问题，会引发更多驱动调用错误。
• 安装完NuGet包如果依然提示找不到类型，清理解决方案后重新生成即可，多数是项目缓存导致的引用未加载问题。

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