iOS自动化测试Appium报错：Returned value cannot be converted to WebElement

问题原因分析 #

先帮你拆解下核心问题：

1. Selenium版本依赖冲突：你在gradle里指定了selenium-server:3.9.1，但报错里显示的版本是3.11.0——这说明Appium Java Client 6.0.0-BETA5本身依赖的Selenium版本是3.11.0，你的手动指定被传递依赖覆盖了，版本不兼容直接导致元素转换失败。
2. iOS定位方式错误：@text是Android元素常用的文本属性，iOS元素的文本通常存在label或name属性中，用@text定位大概率找不到有效元素，进而触发转换错误。

具体解决方案 #

1. 修复Selenium依赖冲突 #

你需要强制gradle使用指定的Selenium版本，或者排除Appium Client传递的Selenium依赖后手动引入兼容版本：

方法一：排除Appium Client的Selenium传递依赖

修改gradle的dependencies配置：

dependencies { 
    implementation fileTree(dir: 'libs', include: ['*.jar']) 
    implementation 'com.android.support:appcompat-v7:26.1.0' 
    implementation 'com.android.support.constraint:constraint-layout:1.1.0' 
    // 排除Appium Client自带的Selenium依赖，避免版本冲突
    implementation ('io.appium:java-client:6.0.0-BETA5') {
        exclude group: 'org.seleniumhq.selenium', module: 'selenium-java'
        exclude group: 'org.seleniumhq.selenium', module: 'selenium-server'
    }
    // 手动引入指定版本的Selenium依赖
    implementation 'org.seleniumhq.selenium:selenium-server:3.9.1'
    implementation 'org.seleniumhq.selenium:selenium-java:3.9.1' 
    implementation "com.google.code.gson:gson:2.8.2" 
    implementation 'com.squareup.retrofit2:retrofit:2.4.0' 
    implementation 'com.squareup.retrofit2:converter-gson:2.4.0' 
    compileOnly 'org.projectlombok:lombok:1.16.20' 
    annotationProcessor 'org.projectlombok:lombok:1.16.20' 
    testImplementation 'junit:junit:4.12' 
}

方法二：强制指定Selenium版本

在gradle中添加版本强制策略，确保所有依赖统一使用指定版本：

configurations.all {
    resolutionStrategy.force 'org.seleniumhq.selenium:selenium-server:3.9.1'
    resolutionStrategy.force 'org.seleniumhq.selenium:selenium-java:3.9.1'
}

dependencies { 
    // 你的其他依赖配置保持不变
    implementation 'io.appium:java-client:6.0.0-BETA5'
    implementation 'org.seleniumhq.selenium:selenium-server:3.9.1'
    // ... 其他依赖
}

2. 修正iOS元素定位方式 #

把原来基于@text的xpath定位替换为iOS支持的属性，或者使用Appium提供的iOS专属定位器：

方式一：修改XPath定位

try { 
    // 用@label替换@text，iOS元素文本通常存储在label属性中
    MobileElement titleView = navigationBar.findElement(By.xpath("//*[@label='" + title + "']")); 
    return titleView.isDisplayed(); 
} 

方式二：使用iOS专属定位器（推荐）

Appium提供了iOS原生的定位方式，比如iOSNsPredicateString，定位更准确且性能更好：

try { 
    MobileElement titleView = navigationBar.findElement(By.iOSNsPredicateString("label == '" + title + "'")); 
    return titleView.isDisplayed(); 
} 

验证步骤 #

1. 执行gradle dependencies命令，检查Selenium相关依赖的版本是否为3.9.1，确认依赖冲突已解决。
2. 运行测试，确认定位方式正确，元素能被正常找到并转换为MobileElement。

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