Spring Boot 中校验失败抛出 MethodArgumentNotValidException 或 ConstraintViolationException，需分别通过 BindingResult.getAllErrors() 或 getConstraintViolations() 提取字段名与错误信息，并支持国际化和统一响应封装。
在 Java 中，使用 Spring Boot 的 @Valid 或 @Validated 进行参数校验时，若校验失败，默认会抛出 MethodArgumentNotValidException（用于 @RequestBody）或 ConstraintViolationException（用于 @Valid 在方法参数、对象属性等场景）。要捕获异常并提取具体错误字段及说明，关键在于解析异常中携带的校验元数据。
捕获 MethodArgumentNotValidException（@RequestBody 场景）
这是最常见的 REST 接口参数校验异常，发生在控制器方法接收 JSON 请求体并使用 @Valid 注解实体类时。
- 该异常包含一个
BindingResult对象，可通过getBindingResult()获取 -
BindingResult.getAllErrors()返回所有校验错误（包括FieldError和ObjectError） - 对每个
FieldError，调用getField()得到字段名，getDefaultMessage()得到提示信息（即 @NotBlank、@Size 等注解的 message 值）
示例处理逻辑（全局异常处理器）：
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, String>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach((error) -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
return ResponseEntity.badRequest().body(errors);
}
}
捕获 ConstraintViolationException（@Valid 在 Service 层或普通对象校验）
当手动调用 validator.validate(obj)，或在非 Controller 方法参数上使用 @Valid（配合 @Validated）时，可能抛出此异常。
立即学习“Java免费学习笔记（深入）”；
- 异常对象的
getConstraintViolations()返回Set<ConstraintViolation<?>> - 每个
ConstraintViolation可通过getPropertyPath().toString()获取带路径的字段名（如"user.name"），getMessage()获取错误提示 - 若只需一级字段名，可用
StreamSupport.stream(violation.getPropertyPath().spliterator(), false)取第一个节点的getName()
简化提取方式：
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<Map<String, String>> handleConstraintViolation(
ConstraintViolationException ex) {
Map<String, String> errors = new HashMap<>();
ex.getConstraintViolations().forEach(violation -> {
String field = violation.getPropertyPath()
.stream()
.map(Path.Node::getName)
.reduce((first, last) -> last) // 取最后一级字段名，如嵌套对象取 "name"
.orElse("unknown");
errors.put(field, violation.getMessage());
});
return ResponseEntity.badRequest().body(errors);
}
统一返回结构 + 国际化支持（可选进阶）
若项目启用了 Spring 的消息源（MessageSource），校验注解中的 message = "{user.name.notBlank}" 可自动解析为多语言文案。确保配置了 ResourceBundleMessageSource 并有对应 properties 文件。
- 在异常处理器中注入
MessageSource，用getMessage(error, LocaleContextHolder.getLocale())替代getDefaultMessage()，获得本地化提示 - 推荐将错误封装为标准响应体（如
Result<Map<String, String>>），而非裸 Map，便于前端统一处理
注意事项与常见坑
避免因疏忽导致错误信息无法正确提取：
- 确认实体类字段已加校验注解（如
@NotBlank），且类上有@Valid（方法参数）或接口方法有@Validated -
BindingResult必须紧跟在被校验参数之后声明，否则 Spring 不会注入，导致校验失效 - 嵌套对象校验需在对应字段上加
@Valid，否则子对象字段不触发校验 - 自定义校验注解需实现
ConstraintValidator，并在initialize()中设置 message 模板，才能被统一提取
