无控制器无ControllerAdvice的Spring Boot应用Hibernate Validation异常处理问询

你项目中的校验异常是Spring Boot配置属性绑定阶段触发的BindValidationException，属于Spring上下文初始化阶段的异常，仅作用于Web请求链路的@ControllerAdvice确实无法捕获，可通过以下方案处理：

方案1：监听启动失败事件捕获异常 #

Spring Boot启动失败时会发布ApplicationFailedEvent，你可以通过自定义事件监听器筛选配置绑定校验异常，做自定义日志、告警等处理：

@Component
public class ConfigValidationFailedListener implements ApplicationListener<ApplicationFailedEvent> {
    @Override
    public void onApplicationEvent(ApplicationFailedEvent event) {
        Throwable rootException = event.getException();
        // 逐层匹配配置绑定校验异常
        if (rootException instanceof BindException bindException) {
            bindException.getAllErrors().forEach(error -> {
                // 此处填写你自定义的异常处理逻辑，比如输出结构化日志、触发告警
                System.out.printf("配置校验失败：字段[%s]，错误信息[%s]%n", 
                    ((FieldError)error).getField(), 
                    error.getDefaultMessage()
                );
            });
            // 可自定义退出逻辑，或者包装为自定义异常重新抛出
        }
    }
}

方案2：自定义配置属性校验器嵌入处理逻辑 #

如果你需要在校验触发时直接处理异常（比如替换默认提示、抛出自定义业务异常），可以自定义配置属性专用校验器，Spring Boot会自动优先使用该校验器：

@Component("configurationPropertiesValidator")
public class CustomConfigValidator implements Validator {
    private final Validator defaultValidator = Validation.buildDefaultValidatorFactory().getValidator();

    @Override
    public boolean supports(Class<?> clazz) {
        // 只匹配加了@Validated注解的配置类，可根据自己的需求调整规则
        return clazz.isAnnotationPresent(Validated.class);
    }

    @Override
    public void validate(Object target, Errors errors) {
        Set<ConstraintViolation<Object>> violations = defaultValidator.validate(target);
        if (!violations.isEmpty()) {
            // 自定义异常处理逻辑，比如抛出你自定义的业务异常
            String errorMsg = violations.stream()
                .map(v -> String.format("字段[%s]错误：%s", v.getPropertyPath(), v.getMessage()))
                .collect(Collectors.joining(","));
            throw new IllegalArgumentException("配置校验失败：" + errorMsg);
        }
    }
}

方案3：运行时Bean方法校验的异常处理 #

如果你是给普通业务Bean加了@Validated做运行时的方法参数/返回值校验，抛出的是ConstraintViolationException，可以直接在调用外层手动捕获，或者通过Spring AOP统一切面捕获处理：

// 手动捕获示例
try {
    userService.addUser(userParam);
} catch (ConstraintViolationException e) {
    e.getConstraintViolations().forEach(v -> {
        // 自定义处理逻辑
        System.out.println("参数校验失败：" + v.getMessage());
    });
}

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