在 @RequestBody 后直接对 List<User> 使用 @Valid 无效，因 Bean Validation 不递归校验集合元素；推荐用包装类（如 UserBatchRequest）并在其 List 字段加 @Valid，或使用 ValidList 工具类、手动调用 Validator 实现校验。
直接在 @RequestBody 后加 @Valid 或 @Validated 标注 List<User> 是无效的——因为 Bean Validation 规范默认不递归校验集合元素，只校验容器本身（而 List 接口没有字段可校验）。要真正触发每个元素的校验规则，必须显式告诉框架“这个集合里的每个对象都需要校验”。
用包装类承载 List（最推荐）
这是最清晰、标准、易测试的方式。核心是把集合封装进一个 DTO，并在该字段上加 @Valid。
- 定义带校验规则的实体类（如
User），字段标注@NotBlank、@Min等 - 新建包装类，例如：
@Data<br>public class UserBatchRequest {<br> @Valid<br> private List<User> users;<br>} - 控制器方法接收该包装类：
@PostMapping("/users/batch")<br>public Result save(@RequestBody @Validated UserBatchRequest request) { ... } - 这样 Spring 就会逐个校验
request.users中每个User实例的字段
自定义 ValidList 工具类（轻量灵活）
适合不想新增 DTO 的场景，本质是让集合自身携带校验语义。
- 创建泛型包装类，实现
List接口，内部持有一个真实List，并在其字段上加@Valid：@Data<br>public class ValidList<E> implements List<E> {<br> @Valid<br> private List<E> list = new ArrayList<>();<br> // 实现所有 List 方法，全部委托给 this.list<br>} - 接口参数改为：
@RequestBody @Validated ValidList<User> users - 注意：需确保该类能被 Jackson 正确反序列化（建议添加无参构造 + getter/setter）
手动调用 Validator（完全可控）
适用于需要分组校验、自定义错误聚合或集成到公共基类的场景。
立即学习“Java免费学习笔记（深入）”；
- 注入
javax.validation.Validatorbean - 在 Controller 或 Service 中遍历 List，对每个元素调用
validator.validate(element, group) - 收集所有
ConstraintViolation，拼装统一错误信息后抛出异常（如IllegalArgumentException） - 优势是支持分组（如
Insert.class）、可跳过空元素、便于日志记录
注意事项与避坑点
无论选哪种方式，都需确认以下基础配置已就位：
- 项目已引入
spring-boot-starter-validation依赖 - 实体类字段使用的是
javax.validation.constraints下的标准注解（不是 Spring 自己的） - 不要在
List<User>前写@Valid List<User>—— 这里@Valid作用于类型而非字段，无意义 - 若用分组校验（如
@NotBlank(groups = Insert.class)），接口上要用@Validated(Insert.class)而非单纯@Valid
