在 java 单元测试中,使用 mockmvc 断言 json 的核心方法是调用 jsonpath() 并配合 hamcrest 匹配器。通过传入 json path 表达式定位数据,再使用 is()、containsstring() 或 isemptyornullstring() 等匹配器验证值是否符合预期。若路径不存在会抛出异常,从而确保接口返回了正确的数据结构。

如何断言嵌套对象中的特定字段
当需要验证响应体中深层嵌套的对象属性时,直接使用 JSON Path 的层级语法即可。例如,假设返回的 JSON 结构为 {"user": {"name": "Alice"}},可以通过 $.user.name 直接定位到 name 字段并进行字符串匹配。这种方法避免了手动解析 JSON 字符串的繁琐,且能精确检查业务逻辑生成的具体数值。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.MvcResult;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import static org.hamcrest.Matchers.is;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
void shouldReturnNestedUser() throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/api/user")
.contentType(MediaType.APPLICATION_JSON))
.andExpect(jsonPath("$.user.name", is("Alice")))
.andExpect(jsonPath("$.user.age", is(30)));
}
}如何断言数组类型的集合数据
对于返回列表或数组的接口,JSON Path 提供了索引访问和大小校验功能。可以使用 [0] 获取第一个元素的具体属性,或者使用 length() 函数验证数组长度。这种断言方式适用于分页列表或聚合查询结果,能够同时确认数据的存在性和完整性。如果数组为空,需使用 isEmpty() 进行专门处理。
使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。
立即学习“Java免费学习笔记(深入)”;

@Test
void shouldReturnListOfItems() throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/api/items"))
.andExpect(jsonPath("$.items.length()", is(2)))
.andExpect(jsonPath("$.items[0].id", is(101)))
.andExpect(jsonPath("$.items[1].status", is("active")));
}如何处理可能为空的可选字段
在实际开发中,某些字段可能因业务条件而不返回。此时若直接使用 is() 匹配具体值会导致测试失败。应使用 isEmptyOrNullString() 来兼容 null 值和空字符串,或者使用 doesNotExist() 来验证字段完全未出现在响应中。这有助于提高测试对边界条件的覆盖能力,防止因非必填字段的缺失而引发误报。

















