如何在List类型请求体上使用@Validated注解实现参数校验？

方案一：使用包装类封装List（推荐） #

Spring的@Validated分组校验无法直接作用于List这类集合类型，因为集合本身不是标准Java Bean，无法承载分组校验的元信息。最稳妥的方式是创建专用的批量请求包装类，将List作为其字段传递校验规则：

1. 定义批量请求包装类

@Data
public class VocabularyBatchRequest {
    // @Valid 用于递归校验集合内的每个VocabularyRequest对象
    @Valid
    private List<VocabularyRequest> requests;
}

2. 修改批量接口参数
   将@Validated(VocabularyCreation.class)标注在包装类参数上，Spring会自动将分组校验规则应用到包装类内的每个VocabularyRequest元素：

@PostMapping(value = "/bulk", consumes = APPLICATION_JSON_VALUE)
@ResponseStatus(HttpStatus.CREATED)
public Flux<VocabularyResponse> createBatch(
    @Validated(VocabularyCreation.class) @RequestBody VocabularyBatchRequest batchRequest) {
    return service(VocabularyService.class).createBatch(batchRequest.getRequests());
}

方案二：手动触发校验（适合不愿新增类的场景） #

如果不想创建包装类，可以通过Spring提供的Validator接口手动遍历集合元素执行分组校验：

1. 注入Validator实例
   在控制器类中注入Validator：

@Autowired
private Validator validator;

2. 在方法内执行校验逻辑
   遍历List中的每个VocabularyRequest，调用validator.validate()指定分组，若存在校验错误则抛出标准异常：

@PostMapping(value = "/bulk", consumes = APPLICATION_JSON_VALUE)
@ResponseStatus(HttpStatus.CREATED)
public Flux<VocabularyResponse> createBatch(
    @RequestBody List<VocabularyRequest> requests) {
    for (VocabularyRequest request : requests) {
        Set<ConstraintViolation<VocabularyRequest>> violations = validator.validate(request, VocabularyCreation.class);
        if (!violations.isEmpty()) {
            // 转换为Spring标准校验异常，统一处理错误
            BindingResult bindingResult = new BeanPropertyBindingResult(request, "vocabularyRequest");
            violations.forEach(violation -> {
                FieldError error = new FieldError(
                    bindingResult.getObjectName(),
                    violation.getPropertyPath().toString(),
                    violation.getMessage()
                );
                bindingResult.addError(error);
            });
            throw new MethodArgumentNotValidException(null, bindingResult);
        }
    }
    return service(VocabularyService.class).createBatch(requests);
}

原尝试无效的原因 #

• 尝试1：@Validated标注在方法上时，Spring仅校验方法参数本身，@Valid只能触发元素的默认分组校验，无法传递VocabularyCreation分组规则。
• 尝试2：@Validated不能直接作用于List类型参数，因为集合不是Java Bean，Spring无法将分组规则绑定到集合内的元素。
• 尝试3：@Validated的注解目标（@Target）不包含类型使用（TYPE_USE），因此不能标注在泛型参数上，导致编译错误。

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