使用 @restcontrolleradvice 配合 @exceptionhandler 可以统一捕获数据校验异常。针对 methodargumentnotvalidexception,通过解析其内部的 bindingresult 提取字段错误信息并返回给前端;针对 constraintviolationexception,直接提取路径和消息进行封装。这样能确保所有校验失败都走统一的 json 响应格式。

MethodArgumentNotValidException 如何提取具体字段错误
该异常发生在请求体(@RequestBody)校验失败时。核心做法是获取异常对象中的 BindingResult,遍历其 getFieldErrors() 列表,将每个字段的默认错误消息拼接成字符串返回。这比只返回一个通用错误提示更利于前端定位问题。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.stream.Collectors;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<String> handleValidation(MethodArgumentNotValidException ex) {
String errors = ex.getBindingResult().getFieldErrors().stream()
.map(error -> error.getField() + ": " + error.getDefaultMessage())
.collect(Collectors.joining(", "));
return ResponseEntity.badRequest().body(errors);
}
}
当输入 {"name": ""} 且 name 有 @NotBlank 约束时,程序会抛出 MethodArgumentNotValidException。上述代码执行后,返回的 HTTP 状态码为 400,Body 内容为 name: must not be blank。如果存在多个字段错误,它们会被逗号分隔连接在一起。
ConstraintViolationException 如何处理路径参数校验
该异常发生在请求路径变量(@PathVariable)或查询参数(@RequestParam)校验失败时。由于没有 BindingResult,需要直接从异常的 getConstraintViolations() 集合中获取违规信息。通常提取第一个违规项的路径和消息作为响应内容。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import javax.validation.ConstraintViolation;
import javax.validation.ConstraintViolationException;
import java.util.Set;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<String> handleConstraintViolation(ConstraintViolationException ex) {
Set<ConstraintViolation<?>> violations = ex.getConstraintViolations();
if (!violations.isEmpty()) {
ConstraintViolation<?> violation = violations.iterator().next();
return ResponseEntity.badRequest()
.body(violation.getPropertyPath() + ": " + violation.getMessage());
}
return ResponseEntity.badRequest().body("Unknown constraint violation");
}
}
假设有一个接口 @GetMapping("/users/{id}"),其中 @PathVariable "id" @Min(1) int id。当访问 /users/0 时,Spring 会抛出 ConstraintViolationException。代码执行后,返回的 Body 内容为 id: must be greater than or equal to 1。这种处理方式确保了路径参数校验也能被全局捕获并格式化输出。
同时存在两种校验异常时处理顺序是怎样的
在同一个 @RestControllerAdvice 类中,Spring MVC 会根据异常类型精确匹配对应的 @ExceptionHandler 方法。如果请求体校验失败,优先触发 MethodArgumentNotValidException 的处理逻辑;如果路径参数校验失败,则触发 ConstraintViolationException 的处理逻辑。两者互不干扰,各自独立运行。


















