自定义约束注解必须通过 validatedBy 显式指定 ConstraintValidator 实现类才能绑定校验逻辑；注解需包含 message()、groups()、payload() 三个标准属性，并用 @Constraint 标记。
在 Java 中，@Constraint 元注解本身不直接绑定校验逻辑，它只是用来标记一个自定义约束注解（比如 @ValidEmail），真正的校验行为由配套的 ConstraintValidator 实现类承担。绑定的关键在于：**自定义约束注解必须声明 validatedBy 属性，并指向具体的 ConstraintValidator 实现类**。
1. 定义自定义约束注解
使用 @Constraint 标记你的注解，并通过 validatedBy 指定校验器实现类：
- 注解需包含
message()、groups()、payload()三个标准属性（可直接继承javax.validation.Constraint的模板） -
validatedBy必须显式指定一个（或多个）ConstraintValidator<YourAnnotation, TargetType>类型的实现类
示例：
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = NotBlankIfActiveValidator.class) // ← 关键绑定点
public @interface NotBlankIfActive {
String message() default "字段非空条件不满足";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
2. 实现 ConstraintValidator 接口
创建一个类实现 ConstraintValidator<NotBlankIfActive, String>（泛型参数：约束注解类型、被校验字段类型）：
立即学习“Java免费学习笔记（深入）”；
- 重写
initialize(NotBlankIfActive constraintAnnotation)：可在此读取注解上的配置（如自定义 message 或额外参数） - 重写
isValid(String value, ConstraintValidatorContext context)：返回true表示校验通过，false表示失败 - 若需动态修改错误信息，可用
context.buildConstraintViolationWithTemplate(...).addPropertyNode(...).addConstraintViolation()
注意：该类需是无参构造、线程安全的普通类，不需要额外注册（JSR-303/380 规范要求框架自动发现）。
3. 使用时确保校验器被自动发现
只要满足以下条件，Hibernate Validator（或其他兼容实现）就能自动加载并绑定校验器：
- 自定义注解和对应
ConstraintValidator实现在同一个 classpath 下（通常同模块） -
ConstraintValidator实现类不能是private、final或匿名类，且必须有 public 无参构造方法 - 未手动禁用自动发现（如 Spring 中未设置
spring.validation.enabled=false）
如果使用 Spring Boot，默认已启用；若纯 Java SE 环境，需确保 classpath 中有 hibernate-validator 依赖，并通过 Validation.buildDefaultValidatorFactory() 获取 validator。
4. 验证绑定是否生效
最直接的方式是运行一次校验并观察结果：
- 给字段加上你的自定义注解，例如：
@NotBlankIfActive private String name; - 调用
validator.validate(object)，检查返回的Set<ConstraintViolation<?>>是否包含你预期的错误 - 可在
isValid()方法中加断点或日志，确认是否被调用
若没触发，常见原因包括：注解未正确标注到目标元素、validatedBy 指向了错误类名、校验器类未被编译进 classpath、或用了不支持该注解的校验器实例（如未启用 Bean Validation 的上下文）。
