使用 mockmvc 进行单元测试时,断言 http 状态码的标准做法是在执行请求后调用 .andexpect(status().is(200)) 或 .andexpect(status().isok())。具体实现中,先通过 mockmvc.perform() 发起请求,接着链式调用 andexpect() 并传入由 mockmvcresultmatchers.status() 生成的匹配器对象。若状态码符合预期则测试通过,否则抛出异常中断流程。

如何验证非 200 的成功响应(如 201)
对于创建资源等返回 201 Created 的场景,应使用 .andExpect(status().isCreated())。这比通用的 is(201) 更具语义性,能明确表达业务意图。在 POST 请求处理成功后,控制器通常返回新实体的 URI 或 ID,此时配合状态码断言可确保接口行为完全正确。

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.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@WebMvcTest(UserController.class)
class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
void shouldReturnCreatedWhenUserIsAdded() throws Exception {
mockMvc.perform(post("/users")
.contentType(MediaType.APPLICATION_JSON)
.content("{\"name\":\"Alice\"}"))
.andExpect(status().isCreated());
}
}
如何处理客户端错误(如 400 Bad Request)
当输入数据校验失败时,控制器会返回 400 状态码。此时应使用 .andExpect(status().isBadRequest()) 进行断言。这种断言方式专门针对参数缺失、格式错误或违反约束的情况,有助于验证接口的健壮性和输入过滤逻辑。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;

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.status;
@WebMvcTest(UserController.class)
class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
void shouldReturnBadRequestWhenIdIsMissing() throws Exception {
mockMvc.perform(get("/users")
.param("id", "")) // 空值触发校验失败
.andExpect(status().isBadRequest());
}
}
基于程序中某个输入、条件或结果的具体问题
当程序中存在多个分支且需要区分不同错误类型时,例如同时存在 400 和 404 错误,必须分别使用 isBadRequest() 和 isNotFound() 进行精确断言。若错误地混用或仅使用通用断言,可能导致测试掩盖具体的业务逻辑缺陷。在实际开发中,建议根据控制器的具体返回值类型选择对应的语义化断言方法,以确保测试的准确性和可读性。

















