手动调用 Validator.validate() 校验失败时需显式抛出 ConstraintViolationException，以便全局异常处理器统一捕获处理；若直接抛其他异常则无法被标准校验异常处理器识别。
Spring Validation 校验失败时默认抛出 MethodArgumentNotValidException（针对 @RequestBody）或 ConstraintViolationException（针对 @Valid 方法参数、@Validated 带分组等场景），但如果你手动调用 Validator.validate() 并 throw 异常，它不会自动变成 ConstraintViolationException —— 你需要显式封装。
手动校验后主动抛 ConstraintViolationException
当你使用 Validator 接口进行编程式校验（比如在 service 层或非 controller 场景），校验结果是 Set<constraintviolation>></constraintviolation>。若校验失败，应将这些违规项包装为 ConstraintViolationException 再抛出，这样 Spring 的全局异常处理器（如 @ControllerAdvice）才能统一识别和处理。
- 获取
Validator实例（通常通过javax.validation.Validator或注入LocalValidatorFactoryBean） - 调用
validate()得到违规集合 - 不为空时，用
new ConstraintViolationException(violations)包装并throw
示例：
public void processUser(@Valid User user) {
Set<ConstraintViolation<User>> violations = validator.validate(user);
if (!violations.isEmpty()) {
throw new ConstraintViolationException(violations); // ← 关键：显式抛 ConstraintViolationException
}
// 正常逻辑...
}
确保全局异常处理器能捕获 ConstraintViolationException
Spring Boot 默认已注册对 ConstraintViolationException 的处理（对应 JSR-303 标准异常），但前提是你的异常处理器方法签名明确监听该类型。
立即学习“Java免费学习笔记（深入）”；
- 在
@ControllerAdvice类中添加方法，参数为ConstraintViolationException - 可从中提取
getConstraintViolations()，格式化为统一错误响应（如 code/message/field） - 注意：不要混淆
MethodArgumentNotValidException（含BindingResult）和ConstraintViolationException（纯校验违规集合）
避免误 throw 其他异常类型
手动校验时，切勿直接 throw new RuntimeException("xxx") 或自定义业务异常 —— 这会绕过 Spring Validation 的标准异常链，导致无法被统一的校验异常处理器捕获。
- 如果想复用校验逻辑又保持异常语义一致，始终用
ConstraintViolationException封装 - 若需携带额外上下文（如操作 ID、租户信息），建议继承
ConstraintViolationException自定义异常，而非替换为完全无关类型 - Spring 的
DefaultParameterNameDiscoverer和消息解析器只认标准约束异常及其子类
验证是否生效的小技巧
快速确认异常是否走对路径：
- 打断点在你的
@ControllerAdvice中对应ConstraintViolationException的处理方法，看能否命中 - 检查响应状态码：正常应返回
400 Bad Request，而非500 Internal Server Error - 打印
exception.getClass().getName()，确保是javax.validation.ConstraintViolationException
