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