Spring MVC校验文档疑问：方法校验如何取代参数级校验？

核心概念区分 #

先明确两个校验的触发时机与执行主体：

• 参数级校验：由@RequestBody/@ModelAttribute对应的参数解析器（如RequestResponseBodyMethodProcessor）在参数解析阶段执行，针对标注@Valid/@Validated的对象参数，校验其内部的@NotNull、@Size等约束，失败抛出MethodArgumentNotValidException。
• 方法校验：由MethodValidationInterceptor在方法调用前执行，触发场景包括：
  • 简单类型方法参数直接标注@Min、@NotBlank等@Constraint注解（比如@RequestParam Integer age @Min(18)）
  • 方法标注返回值约束注解（比如方法上的@Valid @NotNull）
    失败抛出HandlerMethodValidationException。

“取代参数级校验”的真实含义 #

文档里的“取代参数级校验”仅针对直接标注@Constraint的简单类型参数，和对象参数的@Valid/@Validated校验无关：

• 当方法校验触发时，原本由参数解析器对简单类型参数的基础校验（比如类型转换后的范围检查）会被跳过，转而由方法校验统一处理这些参数的@Constraint约束。
• 但标注@Valid/@Validated的对象参数，参数解析器的校验逻辑依然会正常执行——因为方法校验默认不处理对象内部的嵌套约束，除非你通过@Validated分组结合@Valid嵌套标注，显式配置方法校验支持这类嵌套校验。

你的实验结果解惑 #

你实验中同时配置了：

• @RequestParam参数加@Min/@Max（触发方法校验）
• Person参数加@Validated（触发参数级校验）

当传入无效Person参数时，参数解析阶段的校验先执行，一旦校验失败就直接抛出MethodArgumentNotValidException，这个异常会被Spring MVC的异常处理机制捕获，导致后续的方法校验（针对@RequestParam的约束）根本没机会运行。

如果要验证方法校验的逻辑，可以调整实验：

1. 传入合法的Person参数，同时传入不符合@Min/@Max的@RequestParam参数，此时会抛出HandlerMethodValidationException，证明方法校验生效。
2. 若想让方法校验同时处理Person对象的内部约束，需要在@Validated中指定分组，同时给Person的约束注解匹配对应分组（Spring Boot默认配置支持该逻辑，但需注意分组一致性）。

总结 #

• “取代参数级校验”是针对简单类型参数的@Constraint注解，不影响对象参数的@Valid/@Validated校验。
• 参数级校验和方法校验执行时机不同，参数解析阶段的校验优先级更高，失败会直接终止后续流程。

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