Spring中无@MethodValidation注解，实际使用@Validated配合MethodValidationPostProcessor实现方法参数校验，需在类上加@Validated、注册处理器，并对@RequestParam等参数直接加校验注解。
Spring 中没有 @MethodValidation 这个注解。你提到的可能是对 @Validated + MethodValidationPostProcessor 机制的误称。实际用于校验方法入参（如 @RequestParam、@PathVariable 或普通方法参数）的，是 Spring 提供的 方法级参数校验能力，核心依赖两个组件：
-
@Validated注解（加在类或方法上） -
MethodValidationPostProcessor后置处理器（注册到 Spring 容器）
下面直接说明怎么用、关键点在哪、常见踩坑项。
✅ 方法入参校验的正确配置方式
要让 @NotNull、@Min、@Size 等注解生效于方法参数（比如 @RequestParam String name），必须满足以下全部条件：
- 在启动类或配置类中注册
MethodValidationPostProcessor - 在 Controller 类（或 Service 接口实现类）上添加
@Validated - 在需要校验的参数上直接写校验注解（如
@NotBlank @Size(min=2)）
@Configuration
public class ValidationConfig {
@Bean
public MethodValidationPostProcessor methodValidationPostProcessor() {
return new MethodValidationPostProcessor();
}
}@RestController
@Validated // ← 必须加在这里！不能只加在方法上
public class UserController {
@GetMapping("/user")
public String getUser(@NotBlank @Size(max = 10) @RequestParam String name,
@Min(1) @RequestParam Integer age) {
return "Hello " + name;
}
}⚠️ 注意：
@Valid不能用于方法参数校验（它只支持 Bean 层级或嵌套校验），必须用@Validated。立即学习“Java免费学习笔记（深入）”；
✅ 支持校验的参数类型
以下参数写法可被 MethodValidationPostProcessor 拦截并校验：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
@RequestParam（GET 查询参数） -
@PathVariable（URL 路径变量） - 普通方法参数（如 Service 方法中的
String id） - 接口方法参数（配合
@Validated接口 + 实现类代理）
不支持：
-
@RequestBody（它走的是@Valid/@Validated+BindingResult流程，和 MethodValidation 无关） -
@ModelAttribute（需搭配@Valid和Errors）
✅ 错误处理统一返回
默认校验失败会抛出 ConstraintViolationException（针对 @Validated 方法参数）或 MethodArgumentNotValidException（针对 @RequestBody + @Valid）。建议全局捕获：
@ControllerAdvice
public class ValidationExceptionHandler {
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<Map<String, String>> handleConstraintViolation(
ConstraintViolationException e) {
Map<String, String> errors = new HashMap<>();
e.getConstraintViolations().forEach(violation ->
errors.put(violation.getPropertyPath().toString(),
violation.getMessage()));
return ResponseEntity.badRequest().body(errors);
}
}✅ 分组校验也支持（进阶用法）
如果你的方法在不同场景下需要不同校验规则，可以定义校验分组：
public interface CreateGroup {}
public interface UpdateGroup {}
public class User {
@Null(groups = CreateGroup.class)
@NotNull(groups = UpdateGroup.class)
private Long id;
@NotBlank(groups = {CreateGroup.class, UpdateGroup.class})
private String name;
}然后方法上指定分组：
@PostMapping("/user")
public String createUser(@Validated(CreateGroup.class) @RequestBody User user) {
return "created";
}注意：分组校验对 @RequestParam 参数无效（因为无法绑定分组到基本类型），仅适用于 @RequestBody 或自定义对象参数。
不复杂但容易忽略。
