Spring Boot中@Valid和@Validated如何正确校验List？5分钟搞定集合元素验证

Spring Boot集合校验实战：@Valid与@Validated的深度应用指南

在Java后端开发中，数据校验是保证系统健壮性的第一道防线。Spring Boot提供了强大的校验机制，但当面对集合类型参数时，许多开发者常会遇到校验失效的"黑盒"问题。本文将彻底解析集合校验的底层逻辑，并提供可复用的解决方案。

1. 集合校验失效的核心原因剖析

当我们在Spring Boot应用中尝试用@Valid注解校验List时，经常会发现校验规则"神秘消失"。这种现象背后隐藏着三个技术层面的原因：

1. JSR-303规范的设计局限：Java标准校验规范(JSR-303)最初设计时，主要针对单个对象的属性校验，未充分考虑集合元素的递归校验场景。@Valid作为规范的一部分，默认不会穿透到集合内部元素。

2. Spring的代理机制差异：Spring框架通过MethodValidationPostProcessor实现方法级校验，而@Validated注解会触发该处理器的拦截逻辑。普通的@Valid注解则依赖不同的校验路径。

3. 嵌套校验的传播中断：集合类型在Java中作为特殊容器，会中断校验注解的传播链。即使元素类定义了校验规则，也需要显式声明穿透校验。

// 典型的问题代码示例
@PostMapping("/users")
public void createUsers(@Valid @RequestBody List<User> users) {
    // 即使User类有@NotNull等注解，校验也不会执行
}

提示：Spring Boot 2.3+版本已对集合校验有更好支持，但依然需要正确组合使用注解

2. 解决方案的四种实现模式

2.1 基础组合方案

最直接的解决方案是组合使用@Validated和@Valid注解：

@RestController
@Validated // 类级别启用Spring校验
public class UserController {
    
    @PostMapping("/users")
    public ResponseEntity<String> batchCreate(
        @Valid @RequestBody List<@Valid User> users) {
        // 双重注解确保集合和元素都被校验
        return ResponseEntity.ok("校验通过");
    }
}

关键点说明：

• 类级别的@Validated激活Spring的校验拦截器
• 方法参数的@Valid触发JSR-303校验
• 泛型参数的@Valid确保校