spring boot 中可通过自定义约束注解+校验器封装多条件校验逻辑，如 @username 统一校验非空、长度4–20、字母数字下划线；支持分组、空值处理、嵌套校验及前端字段精准定位。
Spring Boot 中参数校验注解本身不支持直接“组合”成新注解（比如用 @NotBlank @Size 定义一个新注解），但可通过自定义约束注解 + 校验器的方式，把多个逻辑封装成一个可复用、语义清晰的注解。这种方式不是语法层面的组合，而是业务逻辑层面的聚合，更灵活也更贴近真实需求。
用自定义注解封装多条件校验逻辑
例如，要求某个字符串字段：非空、长度 4–20、且只能由字母数字下划线组成。与其在字段上堆砌三个注解，不如定义一个 @Username 注解，内部统一校验这三项：
- 定义注解时声明
@Constraint(validatedBy = UsernameValidator.class) - 在
UsernameValidator.isValid()方法里依次判断：value != null、value.length() ∈ [4,20]、value.matches("[a-zA-Z0-9_]+") - 校验失败时，通过
context.buildConstraintViolationWithTemplate()统一返回提示，避免分散 message 属性
复用内置注解能力，避免重复造轮子
自定义校验器中可以调用 Hibernate Validator 的工具类，提升健壮性：
- 用
Validation.buildDefaultValidatorFactory().getValidator()获取 validator 实例，对嵌套对象递归校验（支持@Valid效果） - 借助
ConstraintValidatorContext的disableDefaultConstraintViolation()和addPropertyNode()精确指向出错字段，适配前端表单定位 - 若需兼容空值处理，可在
isValid开头显式检查value == null，再决定是否跳过后续校验（此时应配合@NotNull或@NotBlank单独控制空值策略）
支持分组与条件触发，让扩展更可控
自定义注解天然支持 JSR-380 分组机制，适合不同场景差异化校验：
- 在注解接口中保留
Class>[] groups() default {}，校验器中可通过context.getConstraintDescriptor().getGroups()获取当前分组 - 例如
@Phone注解，在注册时校验格式+唯一性，在修改密码时只校验格式（跳过唯一性查询） - 也可结合 Spring SpEL 表达式（需自行解析），实现“仅当 status == 'ACTIVE' 时才校验邮箱”，但要注意性能与可读性平衡
注意注解目标与运行时可见性
确保自定义注解能被 Spring 正确识别和拦截：
-
@Target({ElementType.FIELD, ElementType.PARAMETER})覆盖常用位置；如需校验方法返回值或类，补全对应类型 -
@Retention(RetentionPolicy.RUNTIME)是必须项，否则反射读不到 - 不要遗漏
@Documented，方便 Javadoc 和 IDE 提示 - 若用于
@RequestBody对象字段，无需额外配置；若用于@RequestParam或@PathVariable单个参数，需在 Controller 类上加@Validated
