Spring Boot如何在@RequestHeader校验中拒绝空字符串无需手动处理？

核心原因 #

你之前的方案无效，是因为：

• @Validated注解加在了控制器接口上，而Spring的方法参数验证依赖AOP代理，仅对实现类生效；
• @RequestHeader(required=true)仅校验请求头是否存在，允许空字符串值；
• 未触发Spring的参数验证机制，导致@NotBlank注解未执行。

解决方案 #

1. 将@Validated添加到控制器实现类 #

必须在控制器的实现类上标注@Validated，而非接口：

@RestController
@Validated // 关键：加在实现类上
public class ControllerImpl implements Controller {
    @Override
    public ResponseEntity<?> processRequest(
        String requestId,
        String optionalHeader,
        String mandatoryHeader,
        SomeRequestObject requestBody
    ) {
        // 业务逻辑
        return ResponseEntity.ok().build();
    }
}

2. 确保验证依赖正确引入 #

确认build.gradle中包含验证依赖（Spring Boot 2.x/3.x通用）：

implementation 'org.springframework.boot:spring-boot-starter-validation'

3. （可选）增强验证规则（防止全空白） #

如果需要严格禁止全空白字符串（比如多个空格），可以搭配@Pattern注解：

@NotBlank
@Pattern(regexp = "\\S+") // 确保至少有一个非空白字符
@RequestHeader(value = "request-id", required = true) String requestId

4. 全局捕获验证异常 #

当验证失败时，Spring会抛出ConstraintViolationException，添加全局异常处理器返回统一错误响应：

@RestControllerAdvice
public class GlobalValidationExceptionHandler {
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Map<String, String>> handleValidationErrors(ConstraintViolationException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getConstraintViolations().forEach(violation -> {
            String paramName = violation.getPropertyPath().toString();
            errors.put(paramName, violation.getMessage());
        });
        return ResponseEntity.badRequest().body(errors);
    }
}

验证效果 #

配置完成后，当请求头request-id或mandatory-header为空字符串、全空白，或不存在时：

• 不存在：返回400（required=true校验）；
• 空/全空白：返回400，携带验证错误信息。

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