本文介绍在 java + selenium 中，如何通过 xpath 动态定位包含特定文本的元素，并操作其相邻的兄弟节点（如点击紧邻的按钮），适用于搜索结果动态变化的场景。

本文介绍在 java + selenium 中，如何通过 xpath 动态定位包含特定文本的元素，并操作其相邻的兄弟节点（如点击紧邻的按钮），适用于搜索结果动态变化的场景。

在 Web 自动化测试中，常遇到搜索结果列表动态渲染的情况：每个结果块包含标题（如 Result1、Result2）和一个操作按钮，且 DOM 结构中按钮与标题处于同一层级（如均为

的子元素）。此时，硬编码索引（如 findElements(...).get(1)）极易因结果顺序或数量变化而失效；更健壮的方式是基于语义定位——先找到目标文本所在的元素，再利用 XPath 轴（axis）关系定位其关联操作控件。

以提供的 HTML 片段为例：

Result1

click

Result2

click

注意：

Result2

与 click 是同级兄弟元素（均位于同一父

下），而非父子关系。因此不能用 //div[text()='Result2']/button（该写法错误，因为 button 不是 div 的子元素）。

✅ 正确做法是使用 XPath 的 following-sibling:: 轴，精确表达“目标

后面的同级 ”：

String targetText = "Result2";
String xpath = "//div[contains(text(), '" + targetText.trim() + "')]//following-sibling::button";
WebElement targetButton = driver.findElement(By.xpath(xpath));
targetButton.click();

⚠️ 关键说明：

• contains(text(), ...) 比 text() = ... 更鲁棒，可容忍前后空格或换行；
• //following-sibling::button 中的双斜杠 // 表示“任意深度的后续兄弟”，但在此结构中，button 是紧邻的下一个兄弟，也可写作 /following-sibling::button（单斜杠更严格，性能略优）；
• 若需增强稳定性，建议添加显式等待：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement targetButton = wait.until(
    ExpectedConditions.elementToBeClickable(
        By.xpath("//div[contains(., '" + targetText.trim() + "')]//following-sibling::button")
    )
);
targetButton.click();

? 进阶提示：若页面存在多个相同文本（如重复的 “Result2”），可结合父容器限定范围，例如：

//li//div[contains(., 'Result2')]/following-sibling::button

或使用 position() 函数选取首个匹配项。

总结：基于内容动态定位 + XPath 轴关系（如 following-sibling, preceding-sibling, parent::）是处理复杂、可变 DOM 结构的核心技巧。它摆脱了对静态索引或绝对路径的依赖，显著提升脚本健壮性与可维护性。