Appium+Flutter自动化出现No such element found错误的排查求助

问题概述 #

使用Appium进行Flutter自动化测试，尝试通过ValueKey、SemanticLabel定位元素时，始终抛出NoSuchElementException错误。

自动化测试代码（Java） #

public static void main(String[] args) throws MalformedURLException, InterruptedException {

    DesiredCapabilities capabilities = new DesiredCapabilities();
    capabilities.setCapability("deviceName", "Android");
    capabilities.setCapability("platformName", "Android");
    capabilities.setCapability("noReset", true);
    capabilities.setCapability("automationName", "Appium");
    capabilities.setCapability("app", "E:\\app-debug.apk");
    URL url = new URL("http://localhost:4723/wd/hub");
    AndroidDriver<WebElement> driver = new AndroidDriver<WebElement>(url, capabilities);

    FlutterFinder find = new FlutterFinder(driver);
    FlutterElement e = find.bySemanticsLabel("text");
    e.getText();
    System.out.println(value);
}

Maven依赖配置（pom.xml） #

<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
        <version>4.1.2</version>
</dependency>

<dependency>
    <groupId>io.github.ashwithpoojary98</groupId>
    <artifactId>appium_flutterfinder_java</artifactId>
        <version>1.0.0</version>
</dependency>

Flutter项目配置 #

pubspec.yaml开发依赖 #

dev_dependencies:
    test: any
    flutter_test:
        sdk: flutter
    flutter_driver:
        sdk: flutter

main.dart修改 #

import 'package:flutter_driver/driver_extension.dart';
void main() {
    enableFlutterDriverExtension();
    runApp(const MyApp());
}

错误日志 #

Exception in thread "main" org.openqa.selenium.NoSuchElementException: The element identified by 'eyJpc1JlZ0V4cCI6ImZhbHNlIiwibGFiZWwiOiJ0ZXh0IiwiZmluZGVyVHlwZSI6IkJ5U2VtYW50aWNzTGFiZWwifQ==' is not present in the cache or has expired. Try to find it again (WARNING: The server did not provide any stacktrace information)
Command duration or timeout: 191 milliseconds
Build info: version: '2.53.1', revision: 'a36b8b1cd5757287168e54b817830adce9b0158d', time: '2016-06-30 19:26:09'
System info: host: 'Isuru', ip: '192.168.137.1', os.name: 'Windows 10', os.arch: 'amd64', os.version: '10.0', java.version: '19.0.1'
Driver info: io.appium.java_client.android.AndroidDriver

问题排查与解决方案 #

1. 版本兼容性修复 #

• 升级Appium Java Client：当前使用的4.1.2版本过于陈旧，与Java 19、新版Appium服务器不兼容，建议升级到最新稳定版（如8.6.0），同时确保Appium服务器为v2.x版本。
• 更新flutterfinder依赖：appium_flutterfinder_java 1.0.0版本缺少对新版Flutter/Appium的支持，检查是否有更新版本，或改用Appium官方的Flutter定位方案。

2. 修正自动化引擎配置 #

Flutter应用需要专用驱动，修改DesiredCapabilities：

• 将automationName改为"Flutter"，而非"Appium"。默认UiAutomator2无法识别Flutter元素，必须启用Flutter驱动。
• 确保Appium服务器已安装Flutter驱动插件，执行命令：appium driver install flutter（仅适用于Appium v2.x）。

3. 元素定位验证与优化 #

• 确认SemanticsLabel配置：检查Flutter页面元素是否正确设置了semanticsLabel: "text"，示例：

  Text(
    "示例文本",
    semanticsLabel: "text",
  )
  

• 添加显式等待：应用启动后需时间加载，直接定位会因元素未渲染失败，添加等待逻辑：

  WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
  FlutterElement e = wait.until(ExpectedConditions.presenceOfElementLocated(find.bySemanticsLabel("text")));
  

4. 应用构建检查 #

• 确保构建的是debug或profile版本APK，release版本会禁用Flutter Driver扩展，导致无法定位元素。
• 重新构建APK，确认enableFlutterDriverExtension()在main函数中优先执行，未被其他逻辑跳过。

5. 重置应用状态 #

将noReset设置为false，测试前重置应用，避免旧缓存干扰元素定位。

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