使用自定义@ValidList校验时返回500而非400，如何修复？

问题原因 #

1. 参数注解与类型冲突：你使用Data extends ArrayList<Entries>作为请求体参数，同时设置@RequestBody(required = false)允许请求体为null，但结合@NotNull注解时，Spring在处理null参数或空JSON请求时，易因类型转换、实例化问题抛出未捕获异常，导致500错误。
2. 类级别校验未触发：@ValidList标注在Data类上，当参数为null时，类级别的校验逻辑不会执行（无实例对象可供校验）；即使实例化为空列表，Spring MVC默认的@Valid注解也可能未触发类级校验规则。
3. 缺少校验异常处理：未配置全局异常处理器捕获校验失败抛出的ConstraintViolationException或MethodArgumentNotValidException，导致Spring返回默认500错误而非400。

修复方案 #

方案一：直接使用List作为参数（推荐）

简化参数类型，避免自定义继承ArrayList的DTO类：

1. 修改Controller方法参数：

public class RequestAPI{
    @PostMapping(value = "/request",
        consumes = MediaType.APPLICATION_JSON_VALUE,
        produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity request(
        @ValidList @Valid @RequestBody(required = false) List<Entries> entries) { 
        // 业务逻辑实现
    }
}

2. 确保@ValidList的@Target包含PARAMETER（你的现有代码已满足，无需修改）：

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ METHOD, FIELD, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Constraint(validatedBy = ListValidator.class)
public @interface ValidList  {
    String message() default "List cannot empty or contain null values";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};
}

方案二：保留自定义Data类，调整校验注解位置

若需保留Data类，按以下步骤修改：

1. 将@ValidList从Data类移到Controller参数上：

public class RequestAPI{
    @PostMapping(value = "/request",
        consumes = MediaType.APPLICATION_JSON_VALUE,
        produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity request(
        @Valid @ValidList @RequestBody(required = false) Data data) { 
        // 业务逻辑实现
    }
}

2. 移除Data类上的@ValidList注解：

public class Data extends ArrayList<@Valid Entries> { }

方案三：添加全局异常处理器（必做）

无论使用哪种方案，都需添加全局异常处理器，将校验异常转为400响应：

@RestControllerAdvice
public class GlobalValidationExceptionHandler {

    // 处理参数级校验异常
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<String> handleConstraintViolation(ConstraintViolationException ex) {
        String errorMsg = ex.getConstraintViolations().stream()
                .map(ConstraintViolation::getMessage)
                .collect(Collectors.joining("; "));
        return ResponseEntity.badRequest().body(errorMsg);
    }

    // 处理对象字段级校验异常
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<String> handleMethodArgumentNotValid(MethodArgumentNotValidException ex) {
        String errorMsg = ex.getBindingResult().getFieldErrors().stream()
                .map(FieldError::getDefaultMessage)
                .collect(Collectors.joining("; "));
        return ResponseEntity.badRequest().body(errorMsg);
    }
}

关键说明 #

• 请求体为null时，参数上的@ValidList会触发校验逻辑，返回false后抛出异常，被全局处理器捕获并返回400。
• 请求体为空数组时，ListValidator的isEmpty()判断会触发校验失败，同样返回400。
• 若保留Data继承ArrayList的方式，Spring会在空数组请求时自动实例化为空列表，避免实例化异常导致的500。

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