使用@Valid+@RequestBody时抛出ConstraintViolationException而非预期异常问题

问题核心原因 #

你遇到的问题本质是校验触发的时机和层级错误：

• 控制器层的@Valid未生效，请求直接进入服务层，在JPA持久化Posts实体时触发校验，抛出ConstraintViolationException（这是JPA/Hibernate实体校验的默认异常）。
• 针对List<PostDTO>的请求，@Valid无法递归校验集合内的元素，导致控制器层校验失效。

具体解决方案 #

1. 为PostDTO添加校验注解 #

你的校验注解都加在了Posts实体类上，但控制器接收的是PostDTO，导致控制器层的@Valid没有可校验的规则，请求直接到服务层。需要将校验注解复制到PostDTO的对应字段上：

public class PostDTO {
    @NotEmpty
    @Size(min = 2, message = "post title should contain atleast 2 character")
    private String title;
    
    @NotEmpty
    @Size(min = 10, message = "post description should contain atleast 10 characters")
    private String description;
    
    @NotEmpty
    private String content;
    // getter、setter省略
}

这样控制器层的@Valid会在请求绑定到PostDTO时触发校验，抛出MethodArgumentNotValidException，进入你重写的handleMethodArgumentNotValid方法。

2. 修复List的校验逻辑 #

@Valid无法直接校验集合类型的请求体，需要通过以下两种方式解决：

方式一：使用包装类包裹List

创建一个专门的DTO包装类，在List字段上添加@Valid：

public class PostDTOListWrapper {
    @Valid
    private List<PostDTO> posts;
    
    // getter、setter
}

修改控制器方法：

@PostMapping(path = "/multiple")
public ResponseEntity<List<PostDTO>> createMultiplePosts(@Valid @RequestBody PostDTOListWrapper wrapper) {
    return new ResponseEntity<>(postService.createMultiplePosts(wrapper.getPosts()), HttpStatus.CREATED);
}

方式二：配合@Validated注解

在控制器类上添加@Validated，然后在List参数上添加@Valid：

@RestController
@RequestMapping("/api/posts")
@Validated // 添加此注解
public class PostController {
    // ...
    
    @PostMapping(path = "/multiple")
    public ResponseEntity<List<PostDTO>> createMultiplePosts(@Valid @RequestBody List<PostDTO> postDTOs) {
        return new ResponseEntity<>(postService.createMultiplePosts(postDTOs), HttpStatus.CREATED);
    }
}

注意：这种方式下，校验失败会抛出ConstraintViolationException，需要在全局异常处理器中添加对应的处理方法：

@ExceptionHandler(ConstraintViolationException.class)
ResponseEntity<ErrorDetails> handleConstraintViolation(ConstraintViolationException exception, WebRequest webRequest) {
    Map<String, String> errors = new HashMap<>();
    exception.getConstraintViolations().forEach(violation -> {
        String fieldName = violation.getPropertyPath().toString();
        String message = violation.getMessage();
        errors.put(fieldName, message);
    });
    ErrorDetails errorDetails = new ErrorDetails(new Date(), "Validation failed", errors.toString());
    return new ResponseEntity<>(errorDetails, HttpStatus.BAD_REQUEST);
}

3. 区分控制器层与服务层校验 #

如果需要在服务层也做校验，建议：

• 服务层方法参数添加@Valid，并在服务类上添加@Validated，此时服务层校验失败会抛出ConstraintViolationException，需要全局处理器处理。
• 控制器层专注于请求参数校验，服务层专注于业务逻辑校验，避免混淆。

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