ConstraintViolationException 默认不用于 Controller 层非实体参数校验，实际抛出的是 MethodArgumentNotValidException；需用 @ControllerAdvice 拦截该异常并提取 BindingResult 错误信息，手动校验场景才直接抛 ConstraintViolationException。
Java 中 ConstraintViolationException 默认只在 JPA/Hibernate 实体持久化时抛出（如 save()），**不会自动触发于 Controller 层的非实体类参数校验失败**。要全局捕获这类校验异常，关键在于：它其实根本不是 ConstraintViolationException，而是 MethodArgumentNotValidException（Spring MVC 对 javax.validation.ConstraintViolationException 的包装）或 BindException —— 取决于你用的是 @Valid + POJO 还是 @Validated + 嵌套校验等场景。
确认你实际遇到的是哪种异常
Controller 中对非实体类（如 DTO）做校验时：
- 用
@Valid @RequestBody MyDto dto→ 校验失败抛MethodArgumentNotValidException（由 Spring 自动捕获并封装） - 用
@Validated @RequestParam或自定义校验逻辑手动调用validator.validate()→ 才可能直接抛原始ConstraintViolationException -
ConstraintViolationException本身属于 Jakarta Bean Validation 规范的底层异常，Spring MVC 默认不把它作为 Web 层的顶层异常暴露
全局捕获非实体参数校验失败（推荐方式）
使用 @ControllerAdvice 拦截 MethodArgumentNotValidException，提取校验错误并统一返回：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, String>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach((error) -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
return ResponseEntity.badRequest().body(errors);
}
}
这样就能捕获所有 @Valid 注解在 @RequestBody、@ModelAttribute 等参数上的校验失败。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
如果真想捕获原始 ConstraintViolationException（手动校验场景）
当你在 Service 或工具类中手动调用校验器时：
@Autowired
private Validator validator;
public void process(MyDto dto) {
Set<ConstraintViolation<MyDto>> violations = validator.validate(dto);
if (!violations.isEmpty()) {
throw new ConstraintViolationException(violations); // 显式抛出
}
}
此时可在全局异常处理器中补充：
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<Map<String, String>> handleConstraintViolation(
ConstraintViolationException ex) {
Map<String, String> errors = new HashMap<>();
ex.getConstraintViolations().forEach(violation ->
errors.put(violation.getPropertyPath().toString(), violation.getMessage())
);
return ResponseEntity.badRequest().body(errors);
}
确保校验注解生效的前提
- DTO 类字段上标注了
@NotNull、@Size、@Email等 jakarta.validation 注解（非 javax） - Maven 引入了
spring-boot-starter-validation（Spring Boot 2.3+ 已默认包含） - Controller 方法参数明确加了
@Valid（@RequestBody）或@Validated（支持分组） - 没有禁用 WebMvcConfigurer 中的默认校验配置
