Appium iOS自动化滚动列表时元素抖动报错问题问询

问题描述 #

• 测试场景：iOS端Appium自动化测试流程中，需滚动国家选择列表查找指定国家元素
• 异常表现：首次执行滚动操作后列表出现抖动，最终触发执行错误，异常效果可参考测试过程录制的运行视频

原有问题代码 #

public void tapOnElementByText(String element) {
    HashMap<String, Object> scrollObject = new HashMap<>();
    JavascriptExecutor js = driver;

    scrollObject.put("direction", "down");
    js.executeScript("mobile: scroll", scrollObject);
    try {
        driver.findElementByIosNsPredicate("label == \"" + element + "\"").click();
    } catch (NoSuchElementException exception) {
        System.out.println("Element not found");
    }
}

• 已尝试方案：参考Stack Overflow社区及Appium官方教程中提及的各类常规解决方案，均未解决问题。

问题根因 #

1. 原有mobile: scroll调用未指定滚动容器，默认对整个应用根视图触发滚动，和国家列表自身的滚动锚点、回弹逻辑冲突，直接引发列表抖动
2. 滚动指令发送后未等待滚动动画完全结束，立刻执行元素查找、点击操作，此时列表元素位置处于动态变化状态，触发交互异常
3. 单次固定方向滚动无闭环逻辑，未判断目标元素是否已在当前视图可见，也没有滚动次数限制，容易出现过度滚动

修复方案 #

修复要点 #

• 调用滚动接口时必须绑定国家列表的容器元素，将滚动作用域限定在列表内部，避免全局滚动触发的系统手势拦截
• 每次滚动后增加滚动停止判断，等列表完全静止后再执行元素查找、点击操作
• 替换单次滚动逻辑为「查找-点击/滚动」循环逻辑，使用小幅度滚动参数，避免大幅滑动触发的列表回弹
• 如果国家选择组件是系统Picker类型，直接使用mobile: selectPickerWheelValue接口，无需手动模拟滚动，稳定性更高

修复后可直接复用的代码 #

import org.openqa.selenium.ElementNotInteractableException;
import org.openqa.selenium.NoSuchElementException;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.RemoteWebElement;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
import java.time.Duration;
import java.util.HashMap;
import java.util.Map;

// 全局初始化显式等待，超时时间可根据实际测试机性能调整
private final WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
// 最大滚动次数，防止出现无限循环
private static final int MAX_SCROLL_TIMES = 15;

public void tapOnElementByText(String targetElementText) {
    // 先定位国家列表容器，定位符需通过Appium Inspector根据实际页面属性替换
    // 普通列表类型为XCUIElementTypeTable，选择器类型为XCUIElementTypePickerWheel
    WebElement listContainer = driver.findElementByIosNsPredicate(
            "type == 'XCUIElementTypeTable' AND label == 'Country Selector'"
    );
    String targetLocator = String.format("label == \"%s\"", targetElementText);

    for (int scrollCount = 0; scrollCount < MAX_SCROLL_TIMES; scrollCount++) {
        try {
            WebElement targetEl = driver.findElementByIosNsPredicate(targetLocator);
            // 等待目标元素可点击，确认列表无动画运行
            wait.until(ExpectedConditions.elementToBeClickable(targetEl));
            targetEl.click();
            return;
        } catch (NoSuchElementException | ElementNotInteractableException e) {
            // 未找到元素时，在列表容器范围内执行小幅度滚动
            HashMap<String, Object> scrollParams = new HashMap<>();
            scrollParams.put("element", ((RemoteWebElement) listContainer).getId());
            scrollParams.put("direction", "down");
            // 降低滚动速度，小幅度滑动避免触发回弹
            scrollParams.put("velocity", 0.3);
            ((JavascriptExecutor) driver).executeScript("mobile: scroll", scrollParams);

            // 等待列表滚动完全停止：连续两次取列表Y轴偏移量一致则判定滚动结束
            wait.until(driver -> {
                Map<String, Object> attrParams = Map.of(
                        "element", ((RemoteWebElement) listContainer).getId(),
                        "name", "originY"
                );
                Object firstY = ((JavascriptExecutor) driver).executeScript("mobile: getAttribute", attrParams);
                try {
                    Thread.sleep(150);
                } catch (InterruptedException ex) {
                    Thread.currentThread().interrupt();
                }
                Object secondY = ((JavascriptExecutor) driver).executeScript("mobile: getAttribute", attrParams);
                return firstY.equals(secondY);
            });
        }
    }
    throw new NoSuchElementException("滚动" + MAX_SCROLL_TIMES + "次后仍未在国家列表找到目标元素：" + targetElementText);
}

补充说明 #

• 如果确认国家选择组件是iOS原生Picker，可直接替换滚动逻辑为官方提供的选择器专用接口，完全避免手动滚动带来的抖动问题：

// Picker组件专用调用示例
Map<String, Object> pickerParams = Map.of(
        "element", ((RemoteWebElement) pickerElement).getId(),
        "order", "next",
        "offset", 0.15
);
((JavascriptExecutor) driver).executeScript("mobile: selectPickerWheelValue", pickerParams);

• iOS 14及以上版本系统对全屏无绑定的滚动事件有额外的手势拦截逻辑，所有列表滚动操作都必须绑定具体的容器元素，不要直接调用无element参数的mobile: scroll接口。

内容的提问来源于stack exchange，提问作者J.Klimov