Selenium(Java)如何选中匹配指定值的多个复选框，滚动页失效怎么解决

• Selenium 仅支持点击当前浏览器视口内的可见元素，当页面数据较多出现滚动条时，不在可视区域的元素点击会直接失效，不会触发选中逻辑
• 你提前一次性获取了所有复选框和文本元素的列表，如果页面是滚动懒加载、或者滚动后DOM重绘，之前缓存的元素引用会变成陈旧元素（Stale Element），导致点击无响应或者索引错位
• 部分前端框架的表格用虚拟滚动实现，不在可视区域的行不会渲染到DOM中，你提前查询的元素列表本身就不完整

核心优化点：点击前先滚动元素到可视区域、关联匹配文本和对应行的复选框避免索引错位、动态查询元素避免缓存失效，修改后代码如下：

import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.support.ui.WebDriverWait;
import org.openqa.selenium.support.ui.ExpectedConditions;
import java.time.Duration;

// 先定义要匹配的目标文件名
String targetDocName = docName + ".pdf";
// 先获取总记录数
int totalRecords = driver.findElements(By.id("$ctrl.item.id")).size();

for (int j = 0; j < totalRecords; j++) {
    // 每次循环重新获取元素，避免DOM更新后引用失效
    List<WebElement> record = driver.findElements(By.id("$ctrl.item.id"));
    WebElement currentRecord = record.get(j);
    String Pname = currentRecord.getText();
    System.out.println("Pdf name- " + Pname);

    if (Pname.equals(targetDocName)) {
        System.out.println(j + " " + Pname);
        // 从当前匹配的文本元素往上找父级行，再定位对应行的复选框，彻底避免索引错位
        WebElement currentRow = currentRecord.findElement(By.xpath("./ancestor::tr[1]"));
        WebElement currentCheckbox = currentRow.findElement(By.className("row-selection-checkbox"));
        
        // 用JS将复选框滚动到可视区域中间
        JavascriptExecutor js = (JavascriptExecutor) driver;
        js.executeScript("arguments[0].scrollIntoView({block: 'center'});", currentCheckbox);
        
        // 显式等待复选框可点击后再操作，替换硬编码休眠
        new WebDriverWait(driver, Duration.ofSeconds(5)).until(ExpectedConditions.elementToBeClickable(currentCheckbox));
        currentCheckbox.click();
    }
}

• 如果是虚拟滚动表格，需要逐页滚动加载所有数据后再做匹配，避免漏查未渲染到DOM中的行
• 不要提前缓存全量元素列表，每次需要时再查询，避免出现StaleElementReferenceException异常
• 优先用显式等待代替Thread.sleep()，减少不必要的等待时间，同时提升脚本稳定性

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