如何提取MethodArgumentNotValidException中的自定义校验提示信息？

1. 先给DTO的校验注解配置自定义提示 #

比如你的UserDto密码字段，直接在@Size的message里写好自定义提示，其他DTO的校验注解也按这个方式配置：

public class UserDto {
    @Size(min = 6, max = 20, message = "密码长度必须在6-20位之间")
    private String password;
    // 其他字段、getter/setter省略
}

2. 写个全局异常处理器通用解析校验异常 #

创建一个带@RestControllerAdvice的全局异常处理类，专门处理MethodArgumentNotValidException，核心是从异常里拿到BindingResult，遍历提取所有字段的自定义错误提示：

import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import org.springframework.http.HttpStatus;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;
import java.util.Set;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理POST/PUT请求中@Valid校验DTO触发的异常
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, String> handleValidationErrors(MethodArgumentNotValidException ex) {
        Map<String, String> errorMap = new HashMap<>();
        BindingResult bindingResult = ex.getBindingResult();
        // 遍历所有字段的校验错误，提取你自定义的提示信息
        for (FieldError fieldError : bindingResult.getFieldErrors()) {
            errorMap.put(fieldError.getField(), fieldError.getDefaultMessage());
        }
        return errorMap;
    }

    // 可选：处理GET请求中@RequestParam参数校验触发的异常
    @ExceptionHandler(ConstraintViolationException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, String> handleParamValidationErrors(ConstraintViolationException ex) {
        Map<String, String> errorMap = new HashMap<>();
        Set<ConstraintViolation<?>> violations = ex.getConstraintViolations();
        for (ConstraintViolation<?> violation : violations) {
            String paramName = violation.getPropertyPath().toString();
            errorMap.put(paramName, violation.getMessage());
        }
        return errorMap;
    }
}

3. 为什么这个方案通用？ #

• 不管是UserDto还是其他任何DTO，只要用了Jakarta的校验注解并配置了message，这个处理器都会自动提取对应的提示，不需要针对每个DTO写单独的处理逻辑。
• 返回的结果只有字段名和错误提示，完全不会暴露异常栈、类路径这些内部细节，简洁又安全。

4. 实际效果示例 #

当密码长度不符合规则时，接口会返回如下JSON：

{
  "password": "密码长度必须在6-20位之间"
}

其他DTO的校验错误（比如用户名不能为空）也会以同样的格式返回你自定义的提示内容。

内容的提问来源于stack exchange，提问作者Jason