Java注解字段校验框架核心是自定义注解+反射+校验逻辑，支持@NotNull、@Min、@Email等注解，统一继承ValidatorAnnotation接口；校验器实现FieldValidator接口，BeanValidator引擎递归校验嵌套对象与集合，返回ValidationError列表而非抛异常。
用 Java 注解实现字段校验框架，核心是自定义注解 + 反射 + 校验逻辑，不依赖 Spring 也能做，但要兼顾易用性、可扩展性和错误提示清晰度。
设计自定义校验注解
从常用场景出发，定义几个基础注解，比如 @NotNull、@Min、@Email，全部标注 @Target({FIELD}) 和 @Retention(RUNTIME)，确保运行时可通过反射读取。
- 每个注解需声明
message()属性，用于返回校验失败提示，支持占位符（如{value}） - 建议统一继承一个标记接口（如
public interface ValidatorAnnotation {}），方便后续扫描识别 - 像
@Min(value = 18)这类带参数的注解，直接用属性传值，避免额外配置类
编写校验器（Validator）与校验引擎
为每种注解写对应校验器，例如 NotNullValidator 判断字段值是否为 null，MinValidator 比较数值大小。所有校验器实现统一接口：
public interface FieldValidator<T extends Annotation> {
boolean supports(Class<T> annotationType);
boolean validate(Object fieldValue, T annotation, Field field);
String getMessage(T annotation, Field field, Object fieldValue);
}
再写一个主校验引擎（如 BeanValidator），它负责：
立即学习“Java免费学习笔记（深入）”；
- 遍历目标对象所有字段，跳过 static / transient 字段
- 检查字段上是否有校验注解，找到匹配的
FieldValidator - 获取字段值（注意 private 字段要
setAccessible(true)） - 执行校验，收集失败结果（推荐封装为
ValidationError(field, message)）
支持嵌套对象与集合字段
真实业务中常有 User.address.city 或 User.tags List<String> 这类结构，校验框架需递归处理：
- 遇到字段类型是普通对象（非基本类型、非字符串、非日期等内置类型），自动递归调用校验引擎
- 遇到
Collection或数组，遍历每个元素并校验（对泛型擦除问题，可用field.getGenericType()提取实际类型） - 为避免无限递归，可加深度限制（如默认最多 5 层）或提供开关关闭嵌套校验
使用示例与错误聚合
最终调用非常简洁：
User user = new User();
user.setName("");
user.setAge(15);
List<ValidationError> errors = BeanValidator.validate(user); // 返回所有失败项
关键细节：
- 不要抛异常中断流程，而是返回
List<ValidationError>，让用户决定如何处理（日志、抛异常、转 JSON） -
ValidationError至少包含字段名（field.getName()）、路径（如"address.zipCode"）、消息文本 - 支持快速失败模式：加个
validateFast()方法，命中第一个错误就返回，适合表单初检
