Spring Boot 中全局异常测试用例怎么写-java教程-PHP中文网

Spring Boot全局异常测试核心是验证@RestControllerAdvice能否正确拦截Controller抛出的特定异常并返回预期响应，包括状态码、code和message字段；推荐使用MockMvc集成测试，覆盖参数校验异常、业务异常、系统异常兜底及处理器单元测试。

spring boot 中全局异常测试用例怎么写

Spring Boot 全局异常的测试用例，核心是验证：当 Controller 抛出特定异常时，@RestControllerAdvice 是否能正确拦截，并返回预期格式的响应（如 Result> 或 ApiResult>），且状态码、code 字段、message 字段均符合设计。

MockMvc 驱动的集成测试（推荐）

这是最贴近真实请求链路的方式，不启动完整容器，但能模拟 HTTP 调用并断言响应体和状态码。

引入 spring-boot-starter-test（已默认包含 MockMvc）
用 @AutoConfigureMockMvc 启用 MockMvc 自动配置
注入 MockMvc 实例，调用 perform() 发起请求
用 andExpect(status().isXXX()) 断言 HTTP 状态码
用 andExpect(jsonPath("$.code").value(400)) 和 andExpect(jsonPath("$.message").value("用户名不能为空")) 断言 JSON 响应字段

示例：测试参数校验异常（MethodArgumentNotValidException）

（假设你有一个接收 @Valid @RequestBody User user 的 POST 接口）

@Test
void whenInvalidUser_thenReturns400() throws Exception {
    String invalidJson = "{\"username\":\"\",\"age\":-5}";
    mockMvc.perform(post("/api/users")
            .contentType(MediaType.APPLICATION_JSON)
            .content(invalidJson))
            .andExpect(status().isBadRequest())
            .andExpect(jsonPath("$.code").value(400))
            .andExpect(jsonPath("$.message").value("username: 用户名不能为空, age: 年龄不能为负数"));
}

业务异常的针对性测试

直接在测试中抛出你的自定义异常（如 BusinessException），验证其是否被 @ExceptionHandler(BusinessException.class) 捕获。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

在 Controller 方法中手动 throw 新的 BusinessException(10001, "用户不存在")
或使用 Mockito 对 Service 层打桩，使其抛出该异常，再调用 Controller
断言返回的 code 是 10001，message 是 "用户不存在"

示例：

@Test
void whenBusinessExceptionThrown_thenReturnsCustomCodeAndMsg() throws Exception {
    mockMvc.perform(get("/api/users/999"))
            .andExpect(status().isOk()) // BusinessException 默认走 200，由 code 字段标识业务失败
            .andExpect(jsonPath("$.code").value(10001))
            .andExpect(jsonPath("$.message").value("用户不存在"));
}