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 属性指定为对应分组接口：

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）传入分组类，触发对应校验：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

@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 注解（类级）或方法参数显式标注。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南