Spring Boot 中分组校验机制怎么使用与配置-java教程-PHP中文网

spring boot分组校验是解决dto多场景复用冲突的核心手段，通过定义空接口标记分组（如create、update），在dto字段注解中指定groups，在controller方法参数用@validated(xxx.class)启用对应校验。

spring boot 中分组校验机制怎么使用与配置

Spring Boot 的分组校验不是“额外功能”，而是解决实际开发中同一 DTO 多场景复用冲突的核心手段。它让新增、修改、导入、审核等不同操作，共用一个实体类，却各自执行专属校验规则。

定义分组接口

分组本质是一组空接口（Marker Interface），只起标记作用，不写方法。通常按业务动作命名：

public interface Create {} —— 用于新增场景
public interface Update {} —— 用于更新场景
public interface Import {} —— 用于批量导入
public interface Audit {} —— 用于审核流程

注意：不要实现任何逻辑，也不需要加注解；接口名大小写和包路径保持清晰一致即可。

在 DTO 中按组挂约束

字段上的校验注解通过 groups 属性绑定到特定分组。未指定 groups 的注解，默认属于 Default 组，会在所有带 @Validated（无参数）或显式含 Default.class 的校验中生效。

示例：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

@Data
public class UserDTO {
  @Null(groups = Create.class)           // 新增时必须为空
  @NotNull(groups = Update.class)        // 更新时必须非空
  private Long id;

  @NotBlank(groups = Create.class)       // 新增必填
  @Size(min = 2, max = 20, groups = {Create.class, Update.class})
  private String username;

  @Email(groups = Import.class)          // 仅导入时校验邮箱格式
  private String email;

  @Size(max = 500, groups = Audit.class) // 仅审核时校验备注长度
  private String remark;
}

关键点：
• 同一字段可同时挂多个分组注解，互不干扰
• 不写 groups 的约束（如 @NotBlank 单独出现）= 全局生效，慎用

Controller 中指定校验组

在接口方法参数上，用 @Validated(XXX.class) 明确启用哪一组规则：

@PostMapping("/user")<br>  public R create(@Validated(Create.class) @RequestBody UserDTO dto)

@PutMapping("/user/{id}")<br>  public R update(@PathVariable Long id, @Validated(Update.class) @RequestBody UserDTO dto)

@PostMapping("/import")<br>  public R importBatch(@Validated(Import.class) @RequestBody List list)

注意：
• Controller 类上加 @Validated（无参）无效，必须写在具体方法参数上
• 集合批量校验时，需配合 @Valid 对泛型元素启用嵌套校验

配套建议：全局异常统一处理

校验失败会抛出 MethodArgumentNotValidException。推荐配置全局异常处理器，提取错误信息并返回结构化响应：

@RestControllerAdvice
public class ValidationExceptionHandler {
  @ExceptionHandler(MethodArgumentNotValidException.class)
  public Result<void> handleValidation(MethodArgumentNotValidException ex) {
    String errorMsg = ex.getBindingResult()
        .getFieldErrors().stream()
        .map(FieldError::getDefaultMessage)
        .collect(Collectors.joining("; "));
    return Result.fail(errorMsg);
  }
}</void>

这样前端收到的始终是统一格式的提示，比如：{"code":400,"msg":"ID不能为空; 用户名不能为空"}