Java中注解本身不能直接实现接口参数的分组校验，但可通过JSR-303/380规范结合自定义分组接口、@Validated、DTO中groups属性及Spring MVC参数绑定，按场景触发对应校验规则。
Java 中注解本身不能直接“实现”接口参数的分组校验，但可以通过 JSR-303/JSR-380（Bean Validation）规范 结合自定义注解、@Valid、分组（groups）和 Spring MVC 的参数绑定机制，实现接口参数的**按场景分组校验**。核心在于：把校验逻辑与业务语义解耦，用分组标记不同使用场景，再由框架自动触发对应规则。
1. 定义校验分组接口
分组本质是空接口，仅作标记用途，用于区分同一字段在不同场景下的校验要求：
public interface CreateGroup {}
public interface UpdateGroup {}
public interface AdminGroup {}
这些接口不需实现任何方法，只作为校验规则的“标签”。
2. 在 DTO 中使用分组注解
将校验注解（如 @NotBlank、@Min）的 groups 属性指定为对应分组接口：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class UserDTO {
@NotBlank(groups = {CreateGroup.class, UpdateGroup.class})
private String username;
@Email(groups = CreateGroup.class)
private String email;
@NotNull(groups = UpdateGroup.class)
private Long id;
@Min(value = 18, groups = AdminGroup.class)
private Integer age;
// getter/setter...
}
这样：
– 创建时校验 username 和 email；
– 更新时校验 username 和 id；
– 后台管理操作（AdminGroup）才校验 age ≥ 18。
3. 在 Controller 接口上指定分组
Spring MVC 支持通过 @Validated（非标准 @Valid）传入分组类，触发对应校验：
@PostMapping("/users")
public Result create(@Validated(CreateGroup.class) @RequestBody UserDTO dto) {
return userService.create(dto);
}
@PutMapping("/users")
public Result update(@Validated(UpdateGroup.class) @RequestBody UserDTO dto) {
return userService.update(dto);
}
@PutMapping("/admin/users")
public Result adminUpdate(@Validated({UpdateGroup.class, AdminGroup.class})
@RequestBody UserDTO dto) {
return userService.adminUpdate(dto);
}
注意：
– 必须用 @Validated 才支持分组，@Valid 不支持传参；
– 可同时指定多个分组，校验会合并生效；
– 若未指定分组，默认只校验无 groups 属性的注解（即默认组 Default.class）。
4. （可选）自定义复合分组或顺序校验
若需更精细控制（例如“先校验基础字段，再校验业务规则”），可定义继承关系的分组：
public interface BasicCheck {}
public interface BusinessCheck extends BasicCheck {}
然后在注解中使用：
@NotBlank(groups = BasicCheck.class) private String username; @Pattern(regexp = "^[a-z]+$", groups = BusinessCheck.class) private String username;
调用时传 @Validated(BusinessCheck.class)，会自动包含 BasicCheck 的校验项。
不复杂但容易忽略的是：分组校验依赖于 Spring 的 MethodValidationPostProcessor（Spring Boot 2.3+ 默认启用），确保项目引入了 spring-boot-starter-validation，且 Controller 类被 @Validated 注解（类级）或方法参数显式标注。
