使用@AndroidFindBy与@iOSXCUITFindBy时AppiumDriver定位失败求助

问题描述 #

使用@AndroidFindBy和错误的@iOSXCUITAndroidFindBy注解定位元素时功能失效，抛出如下错误：

org.openqa.selenium.InvalidSelectorException: Unsupported CSS selector '*[name='introStartButton']'. Reason: 'Error: 'name' is not a valid attribute. Supported attributes are 'checkable, checked, clickable, enabled, focusable, focused, long-clickable, scrollable, selected, index, instance, description, resource-id, text, class-name, package-name''

错误原因 #

1. iOS注解使用错误：不存在@iOSXCUITAndroidFindBy注解，正确的iOS平台定位注解是@iOSXCUITFindBy。错误的注解导致Appium解析时生成了Android不支持的name属性CSS选择器，触发异常。
2. PageFactory初始化方式错误：直接调用PageFactory.initElements(driver, this)是WebDriver通用初始化逻辑，无法正确识别Appium的平台专属注解，必须使用Appium提供的AppiumFieldDecorator处理。

修复方案 #

• 替换错误的iOS注解为@iOSXCUITFindBy
• 使用AppiumFieldDecorator初始化PageFactory，确保Appium能正确解析跨平台定位注解
• 确认Android的@AndroidFindBy(id="introStartButton")中id对应元素的resource-id值准确

修复后完整代码示例 #

package commonSteps.Auth;

import Helpers.Config; 
import Helpers.Utils;
import io.appium.java_client.AppiumDriver;
import io.appium.java_client.pagefactory.AndroidFindBy;
import io.appium.java_client.pagefactory.AppiumFieldDecorator;
import io.appium.java_client.pagefactory.iOSXCUITFindBy;
import io.qameta.allure.Step;
import org.openqa.selenium.WebElement; 
import org.openqa.selenium.support.PageFactory;
import org.testng.annotations.Test;

import java.util.Objects;
import java.time.Duration;

public class simpleClass {
 
    // 跨平台定位器：分别指定Android和iOS的定位策略
    @iOSXCUITFindBy(accessibility = "button_login")
    @AndroidFindBy(id = "introStartButton")
    WebElement loginLocator;

    public AppiumDriver driver;
 
    public simpleClass(AppiumDriver driver) {
        this.driver = driver;
        // 使用Appium专属装饰器初始化，设置元素查找超时时间（示例为10秒）
        PageFactory.initElements(new AppiumFieldDecorator(driver, Duration.ofSeconds(10)), this);
    }
 
    @Test(description = "example")
    public void simpleTest() throws InterruptedException {
        loginLocator.click();
    }
}

额外验证 #

• 运行前确认Appium服务已启动、测试设备连接正常
• 通过Appium Inspector或uiautomatorviewer工具，确认Android元素的resource-id确实为introStartButton

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