Appium使用PageFactory报CSS选择器不支持错误如何解决

这个报错是版本适配错误导致的：

• io.appium java-client 8.0.0版本开始，Appium不再兼容Selenium原生的PageFactory逻辑，直接调用org.openqa.selenium.support.PageFactory.initElements(driver,this)时，框架无法识别@AndroidFindBy这类Appium专属定位注解，会默认降级到用name属性匹配元素，最终抛出Unsupported CSS selector '*[name='username']'的错误。
• 更换为AppiumFieldDecorator初始化时报错，绝大多数情况是8.x版本将PageFactory相关逻辑拆分为独立依赖包，项目未引入对应依赖导致的。

• 补全依赖
  8.0.0版本的java-client中PageFactory是独立模块，必须单独引入，以Maven为例，在pom.xml中添加如下依赖：

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

  如果是Gradle项目，对应引入同版本的pagefactory包即可，注意排查是否有旧版本java-client残留导致的依赖冲突。

• 修正页面对象类代码
  注意必须导入Appium包下的PageFactory，不要导入Selenium原生的PageFactory类，同时8.x版本的AppiumFieldDecorator超时参数仅接受java.time.Duration类型，不要沿用旧版本传TimeUnit的写法。修正后的完整代码如下：

  import io.appium.java_client.AppiumDriver;
  import io.appium.java_client.pagefactory.AndroidFindBy;
  import io.appium.java_client.pagefactory.AppiumFieldDecorator;
  // 注意此处导入的是Appium的PageFactory，不是org.openqa.selenium.support包下的
  import io.appium.java_client.pagefactory.PageFactory;
  import org.openqa.selenium.WebElement;
  import java.time.Duration;
  
  public class LoginPageObjects {
  
      AppiumDriver driver;
  
      @AndroidFindBy(id = "username")
      public WebElement username;
      @AndroidFindBy(id = "password")
      public WebElement passwordElement;
      @AndroidFindBy(xpath = "//android.view.ViewGroup[@content-desc=\"loginBtn\"]/android.widget.TextView")
      public WebElement buttonElement;
  
      public LoginPageObjects(AppiumDriver driver){
          this.driver = driver;
          // 可根据项目实际情况调整元素查找默认超时时间
          PageFactory.initElements(new AppiumFieldDecorator(driver, Duration.ofSeconds(10)),this);
      }
  
      public void setUsernameTextBox(String text){
          username.sendKeys(text);
      }
  
      public void setPasswordTextBox(String text){
          passwordElement.sendKeys(text);
      }
  
      public void clickLoginButton() {
          buttonElement.click();
      }
  }
  

• 你原代码中clickLoginButton()方法存在笔误，写的是点击passwordElement（密码输入框），上述代码已经修正为点击登录按钮对应的buttonElement。
• JDK 18、Selenium 4.1.3和java-client 8.0.0不存在兼容性问题，只要依赖导入正确、包路径导对就可以正常运行Appium端的PageFactory逻辑。

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