Spring如何批量校验所有请求头参数并一次性返回全部错误？

默认Spring处理@RequestHeader(required=true)时，会在遇到第一个缺失的必填请求头时就抛出异常并返回错误，无法一次性返回所有缺失字段的信息。同时如果手动读取请求头做空校验，会导致Swagger-UI无法识别必填标记（*）。以下是可行的解决方案：

解决方案：使用DTO+JSR-380校验注解结合全局异常处理器 #

这种方式既可以让Swagger识别必填标记，又能一次性返回所有校验错误。

1. 引入校验依赖（Spring Boot环境） #

如果项目中没有校验依赖，先添加：

<!-- Maven -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2. 定义请求头DTO类 #

用@RequestHeader注解整个DTO类，字段使用@NotBlank标记必填，Swagger会自动识别该注解并显示必填标记：

import jakarta.validation.constraints.NotBlank;
import org.springframework.web.bind.annotation.RequestHeader;

@RequestHeader
public class RequestHeaderParams {
    @NotBlank(message = "Header1是必填请求头")
    private String header1;

    @NotBlank(message = "Header2是必填请求头")
    private String header2;

    // 生成getter和setter
    public String getHeader1() {
        return header1;
    }

    public void setHeader1(String header1) {
        this.header1 = header1;
    }

    public String getHeader2() {
        return header2;
    }

    public void setHeader2(String header2) {
        this.header2 = header2;
    }
}

3. 修改控制器方法 #

在控制器方法中使用@Valid修饰DTO参数，触发校验逻辑：

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

@RestController
public class TestController {
    @GetMapping("/test")
    public String handleRequestByTwoHeaders(@Valid RequestHeaderParams headerParams) {
        // 业务逻辑处理
        return "success";
    }
}

4. 自定义全局异常处理器 #

捕获ConstraintViolationException，收集所有校验失败的信息并统一返回：

import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

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

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Map<String, String>> handleConstraintViolationException(ConstraintViolationException e) {
        Map<String, String> errorMap = new HashMap<>();
        Set<ConstraintViolation<?>> violations = e.getConstraintViolations();
        
        for (ConstraintViolation<?> violation : violations) {
            // 提取请求头参数名（去除DTO类名前缀）
            String paramName = violation.getPropertyPath().toString().split("\\.")[1];
            errorMap.put(paramName, violation.getMessage());
        }
        
        return new ResponseEntity<>(errorMap, HttpStatus.BAD_REQUEST);
    }
}

效果验证 #

当Header1和Header2都缺失时，接口会返回如下响应：

{
    "header1": "Header1是必填请求头",
    "header2": "Header2是必填请求头"
}

同时Swagger-UI中会为这两个请求头显示必填标记（*），完全符合需求。

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