C# Selenium WebDriver如何点击链接打开新标签页解决循环stale异常

异常原因 #

你遇到的StaleElementReferenceException是因为第一次点击部门按钮后页面跳转/刷新，DOM树重构，之前提前获取的results元素集合已经和原始页面脱离关联，第二次循环操作时就会触发失效异常。采用「新标签页打开子页面→处理完切回原列表页」的逻辑可以完全避免原列表页DOM被修改，从根源解决元素失效问题。

核心实现逻辑 #

• 提前保存原列表页的标签句柄，作为切回的锚点
• 点击链接时通过组合键或JS注入的方式在新标签页打开，不修改原列表页状态
• 子页面逻辑处理完成后关闭新标签，切回原标签继续循环

修改后代码示例 #

// 提前初始化显式等待，可复用在所有需要等待元素加载的场景
WebDriverWait _wait = new WebDriverWait(_driver, TimeSpan.FromSeconds(10));
string year = this.yearTextBox2.Text;
string semester = this.semesterTextBox2.Text;
int numCourses = (int)this.numEnrollments.Value;
int count = 0;

string URL = GetURL(year, semester, "index");
_driver.Navigate().GoToUrl(URL);

// 保存原列表页的标签句柄，后续切回用
string originalTabHandle = _driver.CurrentWindowHandle;
var results = _driver.FindElements(By.CssSelector(".btn.btn-light.btn-block"));

// 改用索引遍历，避免元素缓存失效问题
for (int i = 0; i < results.Count; i++)
{
    // 每次循环重新获取一次按钮列表，彻底避免stale异常
    results = _driver.FindElements(By.CssSelector(".btn.btn-light.btn-block"));
    var currentDeptBtn = results[i];
    
    // 方式1：如果是a标签带href属性，优先用JS开新标签，兼容性最好
    string deptHref = currentDeptBtn.GetAttribute("href");
    _driver.ExecuteScript("window.open(arguments[0])", deptHref);

    // 方式2：如果是JS绑定的按钮，用Ctrl+点击触发新标签打开
    // Actions action = new Actions(_driver);
    // action.KeyDown(Keys.Control).Click(currentDeptBtn).KeyUp(Keys.Control).Build().Perform();

    // 等待新标签加载完成，切换到新标签
    _wait.Until(d => d.WindowHandles.Count == 2);
    string newTabHandle = _driver.WindowHandles.First(h => h != originalTabHandle);
    _driver.SwitchTo().Window(newTabHandle);

    // 原部门页面处理逻辑
    var result2 = _driver.FindElement(By.Id("class-details"));
    var results2 = result2.FindElements(By.XPath("./*[@class=\"class-info card mt-3\"]"));
    var courseCount = 0;

    foreach (var r2 in results2)
    {
        if (count >= numCourses)
            break;

        Course c = new Course();
        c.year = year;
        c.semester = semester;

        var header = r2.FindElement(By.TagName("h3"));
        if (header != null)
        {
            string courseNum = header.Text.Split('-')[0].Trim().ToUpper();
            string[] depAndNum = courseNum.Split(' ');
            c.department = depAndNum[0];
            c.number = depAndNum[1];

            string text = header.Text.Split('-')[1].Trim();
            c.title = text.Substring(4);

            var list = result2.FindElement(By.CssSelector(".row.breadcrumb-list.list-unstyled"));
            if (CourseIsLecture(list.FindElements(By.TagName("li"))))
            {
                c.count = courseCount;
                GetCourseInformation(r2, c);
            }
            else
            {
                courseCount++;
                continue;
            }
        }
        courseCount++;
        count++;
    }

    // 处理完当前部门后关闭新标签，切回原列表页
    _driver.Close();
    _driver.SwitchTo().Window(originalTabHandle);
    // 等待原页面元素稳定
    _wait.Until(d => d.FindElements(By.CssSelector(".btn.btn-light.btn-block")).Count == results.Count);
}

注意事项 #

• 优先选择提取href用JS打开新标签的方式，不会受系统键盘快捷键、页面焦点等环境因素影响，稳定性更高
• 所有需要等待元素加载的场景都用显式等待，不要用强制线程等待，既提升执行效率也避免超时异常
• 采用索引遍历+每次循环重新获取元素集合的方式，就算原页面有轻微刷新也不会触发stale元素异常

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