如何修改Appium滚动方法解决iOS长列表元素查找失败问题

问题根源 #

原方案的核心问题是在滚动前就尝试查找目标元素，但iOS的XCUIElementTypeTable在长列表场景下仅加载当前可见区域附近的Cell，未加载的Cell不在DOM中，直接调用findElementWithWait会触发NoSuchElementException——哪怕后续滚动能显示该元素。

解决方案 #

重写滚动逻辑，采用滚动+循环查找的策略：每次滚动列表容器一段距离后，检查目标元素是否已加载到DOM中，同时增加滚动次数上限避免无限循环。

修改后的代码实现 #

1. 更新DriverHelper.java

import org.openqa.selenium.By;
import org.openqa.selenium.NoSuchElementException;
import org.openqa.selenium.TimeoutException;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
import org.openqa.selenium.remote.RemoteWebElement;
import java.time.Duration;
import java.util.Map;
import java.util.concurrent.TimeUnit;

public class DriverHelper {
    AppiumDriver driver;
    private static final Duration WAIT = Duration.ofSeconds(15);
    private static final int MAX_SCROLL_ATTEMPTS = 10; // 最大滚动次数，可根据列表长度调整
    private static final Duration SCROLL_LOAD_WAIT = Duration.ofSeconds(1); // 滚动后等待加载时间

    public DriverHelper(AppiumDriver driver) {
        this.driver = driver;
    }

    public WebElement findElementWithWait(By by) {
        WebDriverWait wait = new WebDriverWait(driver, WAIT);
        try {
            wait.until(ExpectedConditions.presenceOfElementLocated(by));
            return driver.findElement(by);
        } catch (TimeoutException e) {
            throw new NoSuchElementException(String.format("定位器 %s 对应的元素15秒内未找到", by));
        }
    }

    // 新增：不抛出异常，未找到时返回null
    public WebElement findElementIfPresent(By by) {
        try {
            driver.manage().timeouts().implicitlyWait(1, TimeUnit.SECONDS);
            return driver.findElement(by);
        } catch (NoSuchElementException e) {
            return null;
        } finally {
            driver.manage().timeouts().implicitlyWait(WAIT.toSeconds(), TimeUnit.SECONDS);
        }
    }

    // 重写滚动查找方法：滚动到元素出现或达到最大次数
    public WebElement scrollToElement(By targetLocator) {
        WebElement targetElement = findElementIfPresent(targetLocator);
        int scrollCount = 0;

        // 获取列表容器（XCUIElementTypeTable）
        By tableLocator = AppiumBy.xpath("//XCUIElementTypeTable");
        WebElement table = findElementWithWait(tableLocator);

        while (targetElement == null && scrollCount < MAX_SCROLL_ATTEMPTS) {
            // 针对列表容器执行向下滚动
            driver.executeScript("mobile: scroll", Map.of(
                "element", ((RemoteWebElement) table).getId(),
                "direction", "down",
                "predicateString", "true",
                "toVisible", false
            ));

            // 等待新Cell加载
            try {
                Thread.sleep(SCROLL_LOAD_WAIT.toMillis());
            } catch (InterruptedException e) {
                Thread.currentThread().interrupt();
            }

            // 再次检查目标元素
            targetElement = findElementIfPresent(targetLocator);
            scrollCount++;
        }

        if (targetElement == null) {
            throw new NoSuchElementException(String.format("滚动%d次后仍未找到目标元素：%s", MAX_SCROLL_ATTEMPTS, targetLocator));
        }

        // 最后确保元素完全可见
        driver.executeScript("mobile: scrollToElement", Map.of("element", ((RemoteWebElement) targetElement).getId()));
        return targetElement;
    }

    public boolean isElementVisible(WebElement element){
        WebDriverWait wait = new WebDriverWait(driver, WAIT);
        try {
            wait.until(ExpectedConditions.refreshed(ExpectedConditions.visibilityOf(element)));
            return true;
        } catch (TimeoutException e) {
            return false;
        }
    }
}

2. 更新ListPage.java

import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import io.appium.java_client.AppiumDriver;
import io.appium.java_client.pagefactory.AppiumFieldDecorator;
import org.openqa.selenium.support.PageFactory;

public class ListPage {
    public AppiumDriver driver;
    public DriverHelper driverHelper;

    // 修正构造方法名错误
    public ListPage(AppiumDriver driver) {
        this.driver = driver;
        this.driverHelper = new DriverHelper(driver);
        PageFactory.initElements(new AppiumFieldDecorator(driver), this);
    }

    // 改为返回定位器，而非直接查找元素
    private By listedItemLocator(String itemName){
        return AppiumBy.xpath(String.format("//XCUIElementTypeCell[@label='%s']", itemName));
    }

    // 修正参数类型，调整逻辑顺序
    public boolean isItemListed(String itemName){
        try {
            WebElement targetItem = driverHelper.scrollToElement(listedItemLocator(itemName));
            return driverHelper.isElementVisible(targetItem);
        } catch (NoSuchElementException e) {
            return false;
        }
    }
}

关键优化点 #

• 滚动对象切换：针对列表容器滚动，而非依赖未加载的目标元素，避免提前触发异常
• 循环容错机制：每次滚动后检查元素是否加载，限制最大滚动次数防止无限循环
• 加载等待：滚动后短暂等待，确保新Cell完成DOM加载
• 容错查找：新增findElementIfPresent方法，不抛出异常，让滚动逻辑能持续执行

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