Spring Boot REST API如何返回多字段jakarta.validation约束校验违规信息？

要返回所有字段的校验违规信息，核心是捕获包含完整校验结果的MethodArgumentNotValidException（请求体DTO校验场景）和ConstraintViolationException（路径/请求参数校验场景），而非单个约束异常。以下是具体实现步骤：

1. 定义自定义错误响应DTO #

用于统一封装所有校验错误信息：

import java.util.List;

public class ValidationErrorResponse {
    private int status;
    private String message;
    private List<FieldError> errors;

    // 全参、无参构造器
    // 所有字段的getter、setter

    public static class FieldError {
        private String field;
        private String errorMessage;

        public FieldError(String field, String errorMessage) {
            this.field = field;
            this.errorMessage = errorMessage;
        }

        // getter、setter
    }
}

2. 实现全局异常处理器 #

通过@RestControllerAdvice定义全局异常处理逻辑，收集所有校验错误：

import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
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.RestControllerAdvice;

import java.util.List;
import java.util.stream.Collectors;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理请求体DTO的校验错误
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ValidationErrorResponse> handleRequestBodyValidation(MethodArgumentNotValidException ex) {
        BindingResult result = ex.getBindingResult();
        List<ValidationErrorResponse.FieldError> errorList = result.getFieldErrors()
                .stream()
                .map(error -> new ValidationErrorResponse.FieldError(error.getField(), error.getDefaultMessage()))
                .collect(Collectors.toList());

        ValidationErrorResponse response = new ValidationErrorResponse();
        response.setStatus(HttpStatus.BAD_REQUEST.value());
        response.setMessage("输入参数校验失败");
        response.setErrors(errorList);

        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
    }

    // 处理路径参数、请求参数的校验错误
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<ValidationErrorResponse> handleParamValidation(ConstraintViolationException ex) {
        List<ValidationErrorResponse.FieldError> errorList = ex.getConstraintViolations()
                .stream()
                .map(violation -> {
                    // 提取字段名（去掉DTO前缀）
                    String fieldName = violation.getPropertyPath().toString();
                    if (fieldName.contains(".")) {
                        fieldName = fieldName.substring(fieldName.lastIndexOf(".") + 1);
                    }
                    return new ValidationErrorResponse.FieldError(fieldName, violation.getMessage());
                })
                .collect(Collectors.toList());

        ValidationErrorResponse response = new ValidationErrorResponse();
        response.setStatus(HttpStatus.BAD_REQUEST.value());
        response.setMessage("输入参数校验失败");
        response.setErrors(errorList);

        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
    }
}

3. 确保Controller方法启用校验 #

在请求体参数上添加@Valid注解，路径/请求参数配合@Validated使用：

import jakarta.validation.Valid;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @PostMapping("/users")
    public String createUser(@Valid @RequestBody CreateUserRequest request) {
        // 业务逻辑处理
        return "用户创建成功";
    }
}

示例响应 #

当多个字段校验失败时，返回的JSON响应如下：

{
  "status": 400,
  "message": "输入参数校验失败",
  "errors": [
    {
      "field": "username",
      "errorMessage": "不能为空"
    },
    {
      "field": "age",
      "errorMessage": "必须大于等于18"
    }
  ]
}

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