Spring Boot参数校验核心是基础注解、分组校验和自定义规则：引入spring-boot-starter-validation依赖；用@NotBlank、@NotNull等区分语义；通过AddGroup/UpdateGroup接口实现DTO复用；封装@Phone等自定义注解提升复用性；配合全局异常处理器统一返回格式。
直接上手学，不用绕弯子。Spring Boot 参数校验核心就三块：基础注解用法、分组校验复用、自定义规则封装。学完就能在新增/更新共用一个 DTO 的场景下，不写重复代码、不漏校验逻辑。
先搭好地基：依赖和基础注解
Spring Boot 3 默认不带校验模块，必须显式引入：
DTO 字段加注解是最常用方式，注意区分语义：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- @NotBlank：只用于 String，非 null 且 trim 后长度 > 0
- @NotNull：适用于所有类型，只判 null，不关心空字符串或 0
- @NotEmpty：用于 String、Collection、Map、Array，非 null 且非空
-
@Pattern：正则校验，比如手机号
^1[3-9]\d{9}$ - @Email、@Min/@Max、@Size 按需选用，message 属性务必写清楚提示语
解决实际痛点：一套 DTO，新增和更新不同规则
新增时 ID 必须为空、更新时 ID 必须有值——不用拆两个 DTO。靠分组校验就能搞定：
- 定义两个空接口：
public interface AddGroup {}和public interface UpdateGroup {} - ID 字段同时挂两套约束：
@Null(groups = AddGroup.class)+@NotNull(groups = UpdateGroup.class) - Controller 方法参数指定分组：
@Validated(AddGroup.class)或@Validated(UpdateGroup.class) - 没标 groups 的注解（如
@NotBlank）默认属于Default组，所有场景都会生效
避免重复劳动：把常用规则抽成自定义注解
手机号、身份证号、用户名敏感词等高频校验，别每次都在字段上写 @Pattern。自己封装一个 @Phone 注解：
- 定义注解接口，标注
@Constraint(validatedBy = PhoneValidator.class) - 实现
PhoneValidator类，重写isValid方法，里面写正则或更复杂的逻辑 - 支持 Spring Bean 注入（比如查数据库黑名单），比纯静态校验更灵活
- 用的时候就一行：
@Phone(message = "手机号格式错误") private String phone;
让错误反馈更友好：全局异常处理
校验失败默认返回 400 和一堆 JSON 字段，前端很难解析。加个全局异常处理器统一格式：
- 捕获
MethodArgumentNotValidException（@RequestBody 校验失败） - 捕获
ConstraintViolationException（@RequestParam/@PathVariable 校验失败） - 提取所有
FieldError或ConstraintViolation，组装成{"code":400,"msg":"用户名不能为空","details":[{"field":"username","msg":"不能为空"}]}这样的结构
不复杂但容易忽略：分组之间不冲突、自定义注解要加 @Target 和 @Retention、全局异常类要用 @RestControllerAdvice。照着做一遍，新增/更新接口的参数校验就稳了。
