Selenium使用contains写XPath定位元素报错，用全name可正常定位怎么办

错误原因 #

该报错的核心原因是你写的contains XPath表达式匹配到了多个页面元素，@FindBy注解默认需要映射到唯一的单个WebElement对象，当返回的节点集包含多个元素时，无法直接转换为单个WebElement类型，就会抛出该报错。

你直接填写完整name属性值可以定位成功，是因为完整属性值匹配到的是页面上唯一的元素，不存在多匹配的歧义。

解决方案 #

你可以按照下面的步骤依次排查修复：

• 第一步先验证匹配元素数量：打开浏览器F12控制台，执行$x("//*[contains(@name,'add-to-cart')]")，查看返回的结果长度，如果大于1，就说明确实存在多个匹配项，需要优化你的XPath表达式。
• 优化XPath确保唯一匹配，可选方案如下：
  1. 指定元素标签缩小范围，比如目标是按钮的话，改写为：
     //button[contains(@name,'add-to-cart')]
  2. 结合父级唯一属性定位，比如商品项容器有唯一类名的话可以写为：
     //div[@class='inventory_item']//button[contains(@name,'add-to-cart')]
  3. 如果你确实要取第一个匹配的元素，直接加索引即可：
     //*[contains(@name,'add-to-cart')][1]
• 如果你需要获取所有加购按钮，直接把接收字段的类型改为List即可：

  @FindBy(xpath = "//*[contains(@name,'add-to-cart')]")
  List<WebElement> addToCartBtns;
  

  后续操作时根据下标取对应位置的元素即可。

内容的提问来源于stack exchange，提问作者Mourya Chandra Chittabathina