Selenium随机出现unknown error求助：元素被遮挡无法点击

Hey there, let's figure out why your Selenium script is occasionally failing with that "element not clickable" error!

问题根源 #

The error message spells it out clearly: your target <span> element exists in the DOM, but the <ui-spinner> loading overlay is still covering it when you try to click. Your 60-second implicit wait only ensures the element is present—it doesn't wait for the element to be interactive or for overlays like spinners to disappear. That's why it works sometimes (when the spinner vanishes quickly) and fails other times.

解决方案 #

Here are a few reliable fixes you can implement:

1. 显式等待元素可点击

Instead of relying solely on implicit wait, use an explicit wait to confirm the element is not just present, but ready to be clicked. This is the most recommended approach for interactive actions.

Add this method to your Driver class (or a helper class):

using OpenQA.Selenium.Support.UI;
using OpenQA.Selenium;

public static void WaitForElementToBeClickable(By elementLocator, int timeoutSeconds = 60)
{
    WebDriverWait wait = new WebDriverWait(driver, TimeSpan.FromSeconds(timeoutSeconds));
    wait.Until(ExpectedConditions.ElementToBeClickable(elementLocator));
}

Then use it before clicking your target element:

By linkButtonLocator = By.CssSelector("span.ui-link-button");
Driver.WaitForElementToBeClickable(linkButtonLocator);
Driver.driver.FindElement(linkButtonLocator).Click();

2. 等待Spinner完全消失

Since the spinner is the culprit blocking clicks, you can explicitly wait for it to disappear from the page first.

Add this helper method:

public static void WaitForSpinnerToDisappear(int timeoutSeconds = 60)
{
    WebDriverWait wait = new WebDriverWait(driver, TimeSpan.FromSeconds(timeoutSeconds));
    // Adjust the selector to match your spinner exactly—use a more specific one if needed
    wait.Until(ExpectedConditions.InvisibilityOfElementLocated(By.TagName("ui-spinner")));
}

Use it like this:

Driver.WaitForSpinnerToDisappear();
Driver.driver.FindElement(By.CssSelector("span.ui-link-button")).Click();

3. 备选方案：用JavaScript强制点击

If the first two methods still have occasional failures (rare, but possible), you can use JavaScript to trigger the click directly. This bypasses the "element is covered" check, but note that it's not exactly the same as a real user's click.

IWebElement targetButton = Driver.driver.FindElement(By.CssSelector("span.ui-link-button"));
IJavaScriptExecutor jsExecutor = (IJavaScriptExecutor)Driver.driver;
jsExecutor.ExecuteScript("arguments[0].click();", targetButton);

额外提示 #

Avoid mixing implicit and explicit waits together—this can lead to unpredictable wait times. Stick to explicit waits for interactive actions like clicks, and you'll have more reliable scripts.

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