本文介绍在 java + selenium 中，如何通过 xpath 动态定位包含特定文本的元素，并操作其相邻的兄弟节点（如点击紧邻的按钮），适用于搜索结果动态变化的场景。
本文介绍在 java + selenium 中，如何通过 xpath 动态定位包含特定文本的元素，并操作其相邻的兄弟节点（如点击紧邻的按钮），适用于搜索结果动态变化的场景。
在 Web 自动化测试中，常遇到搜索结果列表动态渲染的情况：每个结果块包含标题（如 Result1、Result2）和一个操作按钮，且 DOM 结构中按钮与标题处于同一层级（如均为 <div> 的子元素）。此时，硬编码索引（如 findElements(...).get(1)）极易因结果顺序或数量变化而失效；更健壮的方式是基于语义定位——先找到目标文本所在的元素，再利用 XPath 轴（axis）关系定位其关联操作控件。
以提供的 HTML 片段为例：
<li>
<div>
<div> Result1 </div>
<button> click </button>
</div>
<div>
<div> Result2 </div>
<button> click </button>
</div>
<!-- 其他结果... -->
</li>注意：<div> Result2 </div> 与 <button> click </button> 是同级兄弟元素（均位于同一父 <div> 下），而非父子关系。因此不能用 //div[text()='Result2']/button（该写法错误，因为 button 不是 div 的子元素）。
✅ 正确做法是使用 XPath 的 following-sibling:: 轴，精确表达“目标 <div> 后面的同级 <button>”：
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 结构的核心技巧。它摆脱了对静态索引或绝对路径的依赖，显著提升脚本健壮性与可维护性。
