Spring中如何自定义Bean Validation，拆分有效对象与错误列表？

要实现不返回400错误，而是分别收集验证通过的对象和关联原始数据的错误信息，需要放弃Spring自动触发的全局验证逻辑，改为手动逐个验证列表中的元素，具体步骤如下：

1. 移除自动验证注解，注入Validator #

先去掉Controller方法上的@Validated，避免Spring自动抛出400错误。然后注入Bean Validation的Validator实例，用于手动验证对象：

@RestController
public class TrackController {
    private final Validator validator;

    // 构造注入Validator（Spring会自动装配默认实现）
    public TrackController(Validator validator) {
        this.validator = validator;
    }

    @PostMapping("/track")
    public CompletableFuture<ResponseEntity<ValidationResult>> sendTopicCallback(@RequestBody Request request) {
        // 后续验证逻辑写在这里
    }
}

2. 定义自定义响应体 #

创建一个用于返回结果的类，分别存储验证通过的对象列表和错误详情（关联原始数据）：

public class ValidationResult {
    private List<MyObjects> validObjects;
    private List<ObjectErrorDetail> errorDetails;

    // 构造器、Getter、Setter省略

    // 嵌套类存储单条错误详情
    public static class ObjectErrorDetail {
        private MyObjects originalObject; // 关联原始数据
        private List<String> errorMessages; // 验证错误信息

        // 构造器、Getter、Setter省略
    }
}

3. 手动遍历验证每个元素 #

在接口方法中遍历Request里的objects列表，逐个验证并分类收集结果：

@PostMapping("/track")
public CompletableFuture<ResponseEntity<ValidationResult>> sendTopicCallback(@RequestBody Request request) {
    List<MyObjects> validList = new ArrayList<>();
    List<ObjectErrorDetail> errorList = new ArrayList<>();

    if (request.getObjects() != null && !request.getObjects().isEmpty()) {
        for (MyObjects obj : request.getObjects()) {
            // 对单个MyObjects执行验证
            Set<ConstraintViolation<MyObjects>> violations = validator.validate(obj);
            
            if (violations.isEmpty()) {
                // 验证通过，加入有效列表
                validList.add(obj);
            } else {
                // 验证失败，生成错误详情
                ObjectErrorDetail errorDetail = new ObjectErrorDetail();
                errorDetail.setOriginalObject(obj);
                // 提取错误信息（可按需扩展，比如加入字段名、约束类型等）
                List<String> messages = violations.stream()
                        .map(ConstraintViolation::getMessage)
                        .collect(Collectors.toList());
                errorDetail.setErrorMessages(messages);
                errorList.add(errorDetail);
            }
        }
    }

    ValidationResult result = new ValidationResult();
    result.setValidObjects(validList);
    result.setErrorDetails(errorList);

    return CompletableFuture.completedFuture(ResponseEntity.ok(result));
}

补充说明 #

• 如果MyObjects内部有嵌套对象（带@Valid注解），默认Validator会递归验证嵌套字段，无需额外配置。
• 若需要更详细的错误信息（比如错误字段名、约束注解类型），可使用ConstraintViolation的getPropertyPath()、getConstraintDescriptor()等方法提取。

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