Selenium webdriver无法定位匹配指定xpath的Vuetify下拉框标签元素

问题原因 #

1. XPath class匹配逻辑错误：contains(@class, '连续多个class值')的写法不具备兼容性，你用的Vuetify组件渲染时class属性的顺序可能动态变化，只要class顺序和你写的字符串不一致，就会匹配失败。
2. 文本匹配遗漏特殊字符：contains(text(),'Narystė')的写法没有处理文本前后的空格、换行、缩进等空白字符，只要元素文本包含这些不可见字符，就会匹配失败。
3. 元素加载时机不匹配：Vuetify的组件渲染是异步的，代码执行查找操作时，元素可能还没有被插入到DOM树中，直接查找必然失败。
4. iframe嵌套问题：如果目标元素被嵌套在iframe标签内，没有先切换iframe上下文的话，Selenium默认在顶层DOM查找，自然找不到元素。

解决方法 #

1. 修正XPath写法
   拆分class匹配逻辑，同时用normalize-space()处理空白字符，更稳定的XPath写法如下：

//div[contains(@class,'v-select')]//label[contains(@class,'v-label--active') and normalize-space(text())='Narystė']

也可以直接通过文本关联v-select组件，避免class变化的影响：

//*[contains(@class,'v-select')]//*[normalize-space(.)='Narystė']

2. 增加显式等待
   不要直接执行查找点击操作，先等待元素处于可交互状态再操作，示例代码如下：

private static final By naryste = By.xpath("//div[contains(@class,'v-select')]//label[normalize-space(text())='Narystė']");

@Step("Pasirenkame juridinio asmens organizaciją iš reikšmių sąrašo")
public createOrganization selectMembership() {
    // 最多等待10秒，直到目标元素可点击
    WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
    wait.until(ExpectedConditions.elementToBeClickable(naryste)).click();
    return this;
}

3. 检查iframe上下文
   如果页面存在iframe嵌套，先切换到对应iframe再执行元素操作，操作完成后切回顶层DOM即可：

// 切换到目标iframe，可传iframe的id、name或者对应WebElement
driver.switchTo().frame("iframeId");
// 执行元素操作后切回主文档
driver.switchTo().defaultContent();

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