Spring Boot中能否拦截自定义注解验证器抛出的异常？

在Spring Boot的Bean Validation（JSR-380）流程中，ConstraintValidator的isValid方法不应该直接抛出业务异常，这是导致你的@ControllerAdvice无法拦截异常的核心原因。Spring的验证框架会捕获验证阶段抛出的非ConstraintViolationException异常，并将其包装或直接终止验证流程，不会将自定义异常传递到全局异常处理器。

正确的验证器实现方式 #

遵循规范，应该通过ConstraintValidatorContext构建验证错误信息，返回false标记验证失败，而不是抛出异常：

public class CustomerValidator implements ConstraintValidator<CustomerValidation, Customer> {
    @Override
    public boolean isValid(Customer value, ConstraintValidatorContext context) {
        boolean isValid = true;

        if (value.getItemList().isEmpty()) {
            // 禁用默认错误提示，自定义错误信息和关联字段
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("订单商品列表不能为空")
                   .addPropertyNode("itemList")
                   .addConstraintViolation();
            isValid = false;
        }

        if (value.getBalance() < value.getCost()) {
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("余额不足以支付订单费用")
                   .addPropertyNode("balance")
                   .addConstraintViolation();
            isValid = false;
        }

        return isValid;
    }
}

全局拦截验证异常 #

此时Spring会将验证失败的信息包装为ConstraintViolationException，你可以在@ControllerAdvice中处理该异常：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ConstraintViolationException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ResponseBody
    public Map<String, String> handleValidationExceptions(ConstraintViolationException ex) {
        Map<String, String> errorMap = new HashMap<>();
        ex.getConstraintViolations().forEach(violation -> {
            // 获取验证失败的字段路径和错误信息
            String fieldPath = violation.getPropertyPath().toString();
            String errorMsg = violation.getMessage();
            errorMap.put(fieldPath, errorMsg);
        });
        return errorMap;
    }
}

若需抛出自定义异常的处理方案 #

如果你一定要在验证逻辑中抛出自定义异常，需要手动触发验证，而不是依赖Spring自动的@Valid/@Validated参数验证：

@RestController
@RequestMapping("/customers")
public class CustomerController {
    @Autowired
    private Validator validator;

    @PostMapping
    public ResponseEntity<Customer> submitOrder(@RequestBody Customer customer) {
        // 手动调用自定义验证器
        CustomerValidator customerValidator = new CustomerValidator();
        customerValidator.initialize(null); // 若注解有参数，传入对应的注解实例
        
        try {
            customerValidator.isValid(customer, null);
        } catch (CustomerOrderException | InsufficientBalanceException ex) {
            // 直接抛出异常，让全局处理器捕获
            throw ex;
        }

        // 业务逻辑处理
        return ResponseEntity.ok(customer);
    }
}

然后在全局异常处理器中添加对应异常的处理：

@ControllerAdvice
public class GlobalExceptionHandler {
    // ... 之前的ConstraintViolationException处理

    @ExceptionHandler({CustomerOrderException.class, InsufficientBalanceException.class})
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ResponseBody
    public Map<String, String> handleCustomValidationExceptions(RuntimeException ex) {
        Map<String, String> error = new HashMap<>();
        error.put("error", ex.getMessage());
        return error;
    }
}

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