Spring Boot中@Validated校验List请求参数返回冗余错误信息问题

方法一：优化ConstraintViolationException异常处理器，提取纯自定义消息 #

你当前用@ControllerAdvice捕获ConstraintViolationException时，ConstraintViolation对象的getMessage()会包含参数路径（比如teacherEmails[0]: teacher email address must be in proper format），我们可以通过两种方式剥离路径部分，只保留自定义消息：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<String> handleConstraintViolation(ConstraintViolationException ex) {
        String errorMessage = ex.getConstraintViolations().stream()
                .map(violation -> {
                    // 方式1：截取路径后的消息（适合注解里明确写死自定义message的场景）
                    String fullMsg = violation.getMessage();
                    int colonPos = fullMsg.indexOf(": ");
                    return colonPos != -1 ? fullMsg.substring(colonPos + 2) : fullMsg;
                    
                    // 方式2：直接获取注解的原始message模板（更可靠，避免字符串截取的潜在问题）
                    // return violation.getConstraintDescriptor().getMessageTemplate();
                })
                .findFirst()
                .orElse("Invalid request parameters");
        return ResponseEntity.badRequest().body(errorMessage);
    }
}

注意：方式2需要确保你在校注解里的message没有使用动态占位符（或占位符已被正确解析），比如@Email(message = "teacher email address must be in proper format")，这种情况下getMessageTemplate()会直接返回你定义的纯消息。

方法二：用包装类封装List，配合@Valid触发MethodArgumentNotValidException #

如果不想处理ConstraintViolationException的路径问题，可以创建一个简单的包装类承载List参数，这样就能用常规的@Valid校验，触发更易处理的MethodArgumentNotValidException：

1. 创建参数包装类：

public class TeacherEmailRequest {
    @NotEmpty(message = "Please input at least one email")
    private List<@NotBlank(message = "teacher Email cannot be blank") 
                  @Email(message = "teacher email address must be in proper format") String> teacherEmails;

    // Getter & Setter
    public List<String> getTeacherEmails() {
        return teacherEmails;
    }

    public void setTeacherEmails(List<String> teacherEmails) {
        this.teacherEmails = teacherEmails;
    }
}

2. 修改Controller方法：

@RestController
@RequestMapping("/api")
public class AdminController {
    // 用@ModelAttribute绑定请求参数，参数名要和包装类的属性名一致
    @GetMapping("/commonstudents")
    public ResponseEntity<?> getCommonStudents(@Valid @ModelAttribute TeacherEmailRequest request) {
        // 业务逻辑实现
        return ResponseEntity.ok("Success");
    }
}

3. 新增MethodArgumentNotValidException处理器：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<String> handleMethodArgumentNotValid(MethodArgumentNotValidException ex) {
        String errorMessage = ex.getBindingResult().getFieldErrors().stream()
                .map(FieldError::getDefaultMessage)
                .findFirst()
                .orElse("Invalid request parameters");
        return ResponseEntity.badRequest().body(errorMessage);
    }

    // 保留原有处理器兼容其他参数校验场景
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<String> handleConstraintViolation(ConstraintViolationException ex) {
        String errorMessage = ex.getConstraintViolations().stream()
                .map(violation -> violation.getConstraintDescriptor().getMessageTemplate())
                .findFirst()
                .orElse("Invalid request parameters");
        return ResponseEntity.badRequest().body(errorMessage);
    }
}

这种方式下，请求URL需调整为http://localhost:8081/api/commonstudents?teacherEmails=1&teacherEmails=teacher2@gmail.com（参数名对应包装类属性），校验错误时会直接返回你定义的纯消息。

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