本文介绍在 Java + Selenium 中，如何基于动态变化的搜索结果文本（如“Result2”）精准定位其邻近的按钮元素并执行点击操作，核心在于使用 XPath 的 following-sibling 轴实现语义化、健壮的元素定位。

本文介绍在 java + selenium 中，如何基于动态变化的搜索结果文本（如“result2”）精准定位其邻近的按钮元素并执行点击操作，核心在于使用 xpath 的 `following-sibling` 轴实现语义化、健壮的元素定位。

在 Web 自动化测试中，搜索结果常为动态渲染的列表，HTML 结构固定但内容不固定（如每次返回的标题不同）。此时若依赖静态索引（如 //button[2]）极易失效；而基于文本内容进行语义化定位，才是稳定可靠的实践方式。

以如下 HTML 片段为例：

<li>
    <div>
        <div> Result1 </div>
        <button> click </button>
    </div>
    <div>
        <div> Result2 </div>
        <button> click </button>
    </div>
    <div>
        <div> Result3 </div>
        <button> click </button>
    </div>
    <div>
        <div> Result4 </div>
        <button> click </button>
    </div>
</li>

目标：当搜索结果中出现 "Result2" 时，点击其同级

内紧邻的 元素。

✅ 推荐 XPath 表达式（精准、可读、健壮）：

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

⚠️ 注意：原答案中 //div[contains(text(),'Result2')]//following-sibling::button 存在两处隐患：

• text() 仅匹配直接子文本节点，若
  内含嵌套标签（如 Result2）则匹配失败；
• //（后代轴）会跨层级搜索，可能误匹配深层嵌套的 button；
  ✅ 正确写法应使用 .（当前节点全部文本内容）+ /（直接子元素关系），确保定位在同一
  容器内且按钮是其直接后续兄弟元素。

  Java + Selenium 实现示例：

  WebDriver driver = new ChromeDriver();
  driver.get("your-test-url");
  
  String targetText = "Result2";
  String xpath = "//div[contains(., '" + targetText.trim() + "')]/following-sibling::button";
  
  try {
      WebElement targetButton = driver.findElement(By.xpath(xpath));
      targetButton.click();
      System.out.println("Successfully clicked button for: " + targetText);
  } catch (NoSuchElementException e) {
      throw new RuntimeException("No button found adjacent to div containing text: " + targetText, e);
  }

  ? 进阶建议：

  • 使用 WebDriverWait 显式等待元素可点击，提升稳定性：

    new WebDriverWait(driver, Duration.ofSeconds(10))
        .until(ExpectedConditions.elementToBeClickable(By.xpath(xpath)))
        .click();

  • 若需支持模糊匹配或忽略空白/大小写，可结合 JavaScript 执行或预处理文本（如 normalize-space() 函数）；
  • 对于复杂场景（如多层嵌套、动态 class），优先考虑 CSS 选择器组合 + WebElement.getText() 校验，作为 XPath 的补充策略。

  总结：基于内容驱动的定位优于位置驱动；善用 contains(., 'xxx') 和 following-sibling:: 等 XPath 轴，可写出高可维护、抗结构微调的自动化脚本。