Python Selenium下拉框选择超时问题：无法选中指定选项

我尝试打开下拉框并选中指定选项「Unscheduled Principal Payment (USD)」。页面中有多个使用相同类名的下拉框，因此我定位了搜索输入框，成功打开下拉框后，尝试选中目标选项时出现Timeout Error。

search_field = self.get_search_field()
search_field.find_element(By.XPATH, "following-sibling::button[@class='multi-select-clear']").click()
xpath = f"//following::span//{tag}[contains(text(),'{value}')]"
# xpath = f"//*[contains(@class, 'selectList')]//{tag}[contains(text(),'{value}')]"
self.wait.until(expected_conditions.visibility_of_element_located((By.XPATH, xpath)))
search_field.send_keys(value)

<div data-v-c3fbf650="" class="checkboxLayer show">
    <div data-v-c3fbf650="" class="helperContainer">
        <div data-v-c3fbf650="" class="line" style="position: relative;">
            <input data-v-c3fbf650="" placeholder="Search..." type="text" class="inputFilter">
            <button data-v-c3fbf650="" type="button" class="multi-select-clear">
                <i data-v-c3fbf650="" aria-hidden="true" class="v-icon notranslate multi-select-clear-icon material-icons theme--light material-symbols-outlined" size="18" style="font-size: 18px; font-variation-settings: &quot;FILL&quot; 0, &quot;wght&quot; 300, &quot;GRAD&quot; 200, &quot;opsz&quot; 48;">clear</i>
            </button>
        </div>
    </div>
    <div data-v-c3fbf650="" class="checkBoxContainer">
        <ul data-v-c3fbf650="" class="selectList">
            <li data-v-c3fbf650="" class="selectItem">
                <span data-v-c3fbf650="" class="ml-5"> Scheduled Principal Payment (USD) </span></li>
            <li data-v-c3fbf650="" class="selectItem">
                <span data-v-c3fbf650="" class="ml-5"> Unscheduled Principal Payment (USD) </span></li>
        </ul>
    </div>
</div>

问题根源 #

1. XPath全局搜索易冲突：原XPath用//following::span会匹配页面所有后续的span元素，加上页面有多个同类下拉框，很可能定位到其他下拉的选项，导致等待超时。
2. 未做相对定位：没有基于已找到的search_field限定搜索范围，无法精准指向当前下拉框的选项列表。
3. 缺失选中操作：代码仅完成了搜索输入，没有实际点击选中目标选项。

修正代码 #

search_field = self.get_search_field()
# 清空搜索框
search_field.find_element(By.XPATH, "following-sibling::button[@class='multi-select-clear']").click()

value = "Unscheduled Principal Payment (USD)"
# 基于当前搜索框做相对定位，锁定所属下拉框的目标选项，用normalize-space处理文本空格
option_xpath = f".//ancestor::div[@class='checkboxLayer show']//ul[@class='selectList']//span[normalize-space(text())='{value}']"

# 等待目标选项可见
target_option = self.wait.until(expected_conditions.visibility_of_element_located((By.XPATH, option_xpath)))
# 输入搜索词过滤选项
search_field.send_keys(value)
# 点击选中目标选项
target_option.click()

关键优化点 #

• 相对定位限制范围：通过ancestor::div[@class='checkboxLayer show']锁定当前已展开的下拉框容器，避免跨下拉框干扰。
• 文本匹配优化：用normalize-space()处理选项文本的前后空格，解决HTML中span文本带空格导致匹配失败的问题。
• 补全选中操作：添加target_option.click()完成选项选中动作。

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