在 java 单元测试中使用 mockmvc 断言响应头,核心方法是调用 andexpect() 并配合 header() 匹配器。你需要先通过 mockmvc.perform(get("/path")) 发起请求,接着使用 .andexpect(header().string("header-name", "expected-value")) 来验证特定名称的响应头是否包含预期值,或者使用 .andexpect(header().exists("header-name")) 检查响应头是否存在。

如何验证单个响应头的具体值
要验证单个响应头的具体值,应使用 header().string() 方法。该方法接受两个参数:第一个是响应头的名称(字符串),第二个是期望的值(字符串)。如果响应头存在且其值与期望值完全匹配,测试通过;否则抛出异常。这种方法适用于验证如 Content-Type、X-Custom-Header 等具有固定值的头部信息。

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.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@WebMvcTest(MyController.class)
class MyControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
void testSingleHeader() throws Exception {
mockMvc.perform(get("/api/test")
.accept(MediaType.APPLICATION_JSON))
.andExpect(status().isOk())
.andExpect(header().string("Content-Type", "application/json;charset=UTF-8"))
.andExpect(header().string("X-Custom-Header", "test-value"));
}
}
上述代码展示了如何在一个测试方法中同时验证状态码和两个不同的响应头。注意 Content-Type 的值通常包含字符集信息,需确保与实际返回一致。若只需验证存在性而不关心具体值,可改用 header().exists("X-Custom-Header")。
如何验证多个响应头或集合类型响应头
当需要验证多个响应头时,可以链式调用多次 header() 匹配器,每个调用独立验证一个头部。对于集合类型的响应头(如 Set-Cookie),由于它们可能包含多个值,建议使用 header().valueEquals() 或 header().values() 进行更灵活的匹配。此外,还可以结合 header().doesNotExist() 来确保某些敏感头未被意外设置。

@Test
void testMultipleHeaders() throws Exception {
mockMvc.perform(get("/api/multi")
.header("Authorization", "Bearer token123"))
.andExpect(status().isOk())
.andExpect(header().string("X-Auth-Status", "success"))
.andExpect(header().string("X-Rate-Limit", "100"))
.andExpect(header().doesNotExist("X-Secret-Header"));
}
@Test
void testCollectionHeader() throws Exception {
mockMvc.perform(get("/api/cookies"))
.andExpect(status().isOk())
.andExpect(header().valueEquals("Set-Cookie", "session=abc; Path=/"))
.andExpect(header().valueExists("Set-Cookie"));
}
在验证集合类型响应头时,valueEquals() 会检查是否存在至少一个与给定值完全匹配的条目,而 valueExists() 仅确认该头部存在且非空。这种灵活性使得处理复杂响应场景更加可靠。避免硬编码完整的多值字符串,而是针对每个子项单独验证。
基于程序中某个输入、条件或结果的具体问题
在实际开发中,一个常见的问题是:当控制器返回空对象或 null 时,MockMvc 是否会仍然生成预期的响应头?答案是肯定的,只要控制器逻辑中显式设置了响应头,即使响应体为空,这些头部依然会被包含在 MockHttpServletResponse 中。因此,在编写单元测试时,无需担心因响应体为空而导致头部验证失败,只需关注头部本身的设置逻辑即可。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











