App自动化脚本无法定位元素，但Appium Inspector可手动定位该元素

问题详情 #

运行自动化脚本时出现错误：
FAILED: org.TsApp.B004_passenger_search.PassengerSearchName
org.openqa.selenium.NoSuchElementException: 使用给定的搜索参数无法在页面上定位到元素。
Build info: version: '4.16.1', revision: '9b4c83354e'
System info: os.name: 'Linux', os.arch: 'amd64', os.version: '5.14.0-1059-oem', java.version: '17.0.9'
Driver info: io.appium.java_client.android.AndroidDriver
Command: [c0263d75-e56d-4648-8578-4ef969c810dc, findElement {using=xpath, value=//android.widget.TextView[@text='PNR Search']}]

补充信息：

• 通过Appium Inspector可正常定位目标元素
• 已尝试使用ID和Xpath定位，均出现相同错误
• 所用Xpath代码：driver.findElement(By.xpath("//android.widget.TextView[@text='PNR Search']")).click();

解决方法 #

• 添加显式等待：脚本执行速度可能快于页面加载，用显式等待确保元素可交互后再操作

  WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
  WebElement pnrSearch = wait.until(ExpectedConditions.elementToBeClickable(By.xpath("//android.widget.TextView[@text='PNR Search']")));
  pnrSearch.click();
  

• 检查上下文/应用包名：确认脚本运行时的上下文与Inspector一致，避免误操作到其他应用或WebView
• 验证元素属性是否动态变化：部分元素的text、id属性可能在页面加载后动态修改，重新用Inspector抓取实时属性替换定位表达式
• 检查Appium服务与设备连接状态：重启Appium服务和测试设备，确保连接稳定无中断
• 尝试组合属性定位：结合多个属性提高定位准确性

  // 示例：结合className和content-desc定位
  driver.findElement(By.xpath("//android.widget.TextView[@content-desc='PNR Search' and @class='android.widget.TextView']")).click();
  

• 关闭设备动画：安卓设备开启动画可能导致元素加载延迟，关闭开发者选项中的窗口动画缩放、过渡动画缩放、动画程序时长缩放

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