如何在Spring Boot Test的MockMvcTester中使用XPath？

在新版Spring Boot Test里，MockMvc的XPath用法核心逻辑和旧版一致，只需遵循当前测试规范并确保导入正确的依赖与静态方法，具体操作如下：

• 导入必要的静态方法
  必须导入MockMvcResultMatchers类下的xpath静态方法，同时按需导入请求构建相关方法：

  import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
  import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.xpath;
  

• 编写完整测试用例
  结合@WebMvcTest注解（针对Web层专属测试）注入MockMvc实例，在测试方法中执行请求并添加XPath断言：

  import org.junit.jupiter.api.Test;
  import org.springframework.beans.factory.annotation.Autowired;
  import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
  import org.springframework.test.web.servlet.MockMvc;
  
  @WebMvcTest(YourTargetController.class) // 替换为你的目标控制器类
  class ControllerXpathTest {
  
      @Autowired
      private MockMvc mockMvc;
  
      @Test
      void testPageContentWithXpath() throws Exception {
          mockMvc.perform(get("/"))
                  // 示例：匹配指定div的文本内容
                  .andExpect(xpath("//div[@id='welcome-banner']").string("欢迎访问"))
                  // 示例：匹配a标签的href属性值
                  .andExpect(xpath("//nav//a[text()='帮助']/@href").string("/help"))
                  // 示例：断言指定节点的数量
                  .andExpect(xpath("//div[@class='card']").nodeCount(4));
      }
  }
  

• 注意事项

  • XPath表达式支持文本匹配、属性提取、节点计数等多种场景，可根据实际响应结构灵活编写
  • 无论返回的是HTML还是XML格式响应，XPath断言的写法完全通用
  • 需确保测试用的XPath表达式与实际返回的文档结构一致，避免因页面/接口结构变更导致测试失败

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