Appium Android滚动失效：element未定义属性读取错误求助

错误根源 #

你遇到的Cannot read properties of undefined (reading 'element')错误，主要由以下几点导致：

• 旧版touchPerform API在UIAutomator2 Driver 2.37.0中存在兼容性问题，参数格式不符合W3C标准
• 滚动坐标计算逻辑有误（如scrollRatio=1.0会让down滚动的终点Y坐标为0，超出屏幕可操作范围）
• 未提前校验元素存在性，直接调用isDisplayed()触发未定义报错

修复方案 #

1. 替换为W3C标准的Actions API #

Appium 2.x官方推荐使用符合W3C规范的performActions替代旧的touchPerform，UIAutomator2 Driver对新API支持更稳定。

2. 修正滚动坐标计算 #

将滚动比例调整为0.6~0.8的合理范围，避免触摸点超出屏幕有效区域。

3. 增加元素存在性校验 #

在判断元素是否显示前，先检查元素是否存在，避免因元素未找到导致的报错。

4. 优化Driver配置 #

在wdio配置文件中添加UIAutomator2的相关配置，确保触摸操作正常：

services: [
  ['appium', {
    driver: {
      automationName: 'UiAutomator2',
      systemPort: 8200,
      ignoreUnimportantViews: true,
      enableMultiWindows: true
    }
  }]
]

修改后的完整代码 #

async scrollDirection(startX: number, startY: number, endX: number, endY: number) {
  // 使用W3C Actions API实现滚动
  await driver.performActions([
    {
      type: 'pointer',
      id: 'finger1',
      parameters: { pointerType: 'touch' },
      actions: [
        { type: 'pointerMove', duration: 0, x: startX, y: startY },
        { type: 'pointerDown', button: 0 },
        { type: 'pointerMove', duration: 800, x: endX, y: endY },
        { type: 'pointerUp', button: 0 }
      ]
    }
  ]);
  await driver.releaseActions();
  await driver.pause(500); // 滚动后等待页面稳定
}

async scrollIntoView(maximumScrolls = 3) {
  const scrollScreenSize = async (direction: 'up' | 'down') => {
    const { width, height } = await driver.getWindowRect();
    const centerX = width / 2;
    const scrollRatio = 0.7; // 合理的滚动比例
    let startY, endY;

    if (direction === 'down') {
      startY = height * 0.8; // 从屏幕下方区域开始
      endY = height * 0.2;   // 滚动到屏幕上方区域
    } else {
      startY = height * 0.2; // 从屏幕上方区域开始
      endY = height * 0.8;   // 滚动到屏幕下方区域
    }

    await this.scrollDirection(centerX, startY, centerX, endY);
  };

  for (let scrolls = 0; scrolls < maximumScrolls; scrolls++) {
    const element = await $(this.selector);
    // 先校验元素存在，再判断是否显示
    if (await element.isExisting() && await element.isDisplayed()) {
      return;
    }

    // 优先向下滚动，最后一次尝试向上
    const direction = scrolls < maximumScrolls - 1 ? 'down' : 'up';
    await scrollScreenSize(direction);
  }

  throw new Error(`无法找到元素 '${this.elementName}'，已尝试滚动${maximumScrolls}次。选择器：${this.selector}`);
}

额外注意事项 #

• 确保测试设备Android版本与UIAutomator2 Driver兼容（Android 8.0+推荐使用最新版Driver）
• 滚动后增加等待时间，避免页面未加载完成就执行后续操作
• 可使用wdio-wait-for库的waitForDisplayed方法替代手动判断，提升稳定性：

  await element.waitForDisplayed({ timeout: 2000 });
  

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