为何Jakarta Validation未自动执行参数校验并抛出异常？及相关困惑

一、为什么Jakarta Validation未自动执行校验并抛出异常？ #

Jakarta Bean Validation（以及Spring Boot的spring-boot-starter-validation）默认不会自动触发静态方法或非Spring管理Bean的方法的参数校验，核心原因如下：

1. Spring校验依赖Bean管理与AOP代理
   Spring的校验能力基于AOP代理实现：只有当方法所属类是Spring上下文托管的Bean（如标注@Service/@Component等注解），且类上添加了@Validated时，Spring才会通过AOP拦截方法调用，自动执行参数校验。而你的toString是静态方法，Spring AOP无法代理静态方法，自然不会触发校验。

2. Bean Validation仅声明约束而非自动执行
   从规范层面看，Jakarta Bean Validation的注解只是约束规则的声明，并非自动执行的触发器。它需要显式调用Validator API，或通过第三方框架（如Spring AOP）提供的拦截机制来触发校验。对于普通静态方法或非托管Bean的方法，不存在内置拦截逻辑自动执行校验。

快速解决方法 #

如果需要触发该静态方法的参数校验，可显式调用Validator API：

import jakarta.validation.Validation;
import jakarta.validation.Validator;
import jakarta.validation.ValidatorFactory;
import jakarta.validation.constraints.PositiveOrZero;
import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import java.math.BigDecimal;
import java.util.Set;

public class NumberFormatUtils {
    private static final Validator validator;

    static {
        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        validator = factory.getValidator();
    }

    public static String toString(
            final BigDecimal numberToFormat,
            @PositiveOrZero final int scale,
            final char decimalSeparator,
            final char groupingSeparator,
            final NumberFormatPattern numberFormatPattern) {

        // 显式校验scale参数
        Set<ConstraintViolation<Object>> violations = validator.validateValue(NumberFormatUtils.class, "toString", scale);
        if (!violations.isEmpty()) {
            throw new ConstraintViolationException(violations);
        }

        String pattern = getPattern(scale, numberFormatPattern);
        return format(numberToFormat, decimalSeparator, groupingSeparator, pattern);
    }

    // 其他方法实现...
}

如果是实例方法，可将类交给Spring管理并添加@Validated：

@Component
@Validated
public class NumberFormatUtils {
    public String toString(
            final BigDecimal numberToFormat,
            @PositiveOrZero final int scale,
            final char decimalSeparator,
            final char groupingSeparator,
            final NumberFormatPattern numberFormatPattern) {
        // 方法逻辑...
    }
}

二、为什么有人会添加约束却不执行校验？ #

添加约束注解但不立即执行校验，通常有以下实用场景：

• 代码契约与文档：注解本身就是可读性极强的代码文档，比如@PositiveOrZero能直接告诉其他开发者「scale参数不能为负数」，比注释更直观且不易过时。
• 开发阶段IDE提示：主流IDE（IntelliJ IDEA、Eclipse）能识别Bean Validation注解，编写代码时如果传入不符合约束的参数，会即时给出警告，提前发现问题。
• 后续复用校验规则：现在不触发校验，将来如果需要整合到其他校验流程（如批量数据校验、自定义AOP拦截器），可直接复用已声明的约束，无需重新编写校验逻辑。
• 灵活控制触发时机：有些团队会自定义校验触发逻辑（比如仅在测试环境或特定业务场景下触发），注解只负责定义规则，执行时机由其他机制灵活控制。

内容的提问来源于stack exchange，提问作者Paul Marcelin Bejan