Record字段校验不能依赖运行时注解，因其无法修改编译生成的final构造器和访问器；真正可插手的是编译期Annotation Processor，需显式判断ElementKind.RECORD类型并操作AST。
Record 字段校验为什么不能靠运行时注解？
因为 @Override、toString()、hashCode() 这些方法在 record 编译后就固化了，运行时反射拿不到字段校验逻辑的注入点；而 @Retention(RetentionPolicy.RUNTIME) 注解只能触发检查，无法修改生成的构造器或访问器。真正能插手的地方只有编译期——也就是 Annotation Processor 在解析 Record 元素时，通过 javax.annotation.processing.ProcessingEnvironment 获取 AST 并生成辅助类或改写构造逻辑。
如何让 Processor 识别 Record 类及其字段？
Java 14+ 的 Record 在 ElementKind 中是独立类型（RECORD），但很多老版本 Processor 模板仍用 TYPE 判断，会漏掉。必须显式检查：
if (element.getKind() == ElementKind.RECORD) {
TypeElement recordType = (TypeElement) element;
List<? extends Element> enclosed = recordType.getEnclosedElements();
// 注意：record 的字段是 RECORD_COMPONENT，不是 FIELD
enclosed.stream()
.filter(e -> e.getKind() == ElementKind.RECORD_COMPONENT)
.forEach(this::processRecordComponent);
}
-
RECORD_COMPONENT是关键类型，不是FIELD，否则拿不到canonical constructor参数信息 - 字段的
@NonNull、@Size等注解需用getAnnotationMirrors()获取，不能用getAnnotation()（后者只支持RUNTIME） - 若 record 声明在嵌套作用域（如方法内、匿名类中），
Element可能为ERROR，需跳过处理
生成校验逻辑时该往哪塞代码？
不能修改原 record 字节码（JSR-269 不允许），只能生成配套类。主流做法是生成一个同名 Validator 辅助类，或在 canonical constructor 调用前插入校验调用——但后者需配合 javac 插件（如 javac-plugin）或字节码增强（非标准 Processor 能力）。更稳妥的是：
- 生成
MyRecordValidator类，含静态validate(MyRecord r)方法，自动调用每个字段的@NotNull、@Min等逻辑 - 若使用 Lombok 风格，可生成带
withXxx()的 builder 类，并在每个 setter 中插入字段级校验 - 避免生成
MyRecord$$Enhancer这类代理类——它破坏 record 的不可变语义，且与equals()/hashCode()行为冲突
示例生成的 validator 片段：
public class UserValidator {
public static void validate(User user) {
if (user.name() == null) {
throw new IllegalArgumentException("name must not be null");
}
if (user.age() < 0) {
throw new IllegalArgumentException("age must be >= 0");
}
}
}
常见陷阱：泛型 record 和模块化环境下的 ClassLoader 问题
Processor 运行在 javac 的上下文中，其 ClassLoader 与应用类路径隔离。当你在注解中引用自定义校验类（如 @ValidateWith(MyCustomRule.class)），Processor 无法直接 Class.forName() 加载它——会抛 ClassNotFoundException，哪怕该类就在同一 module 中。
- 正确做法：用
annotationMirror.getElementValues().get(...)提取注解属性值，而非尝试加载类 - 泛型 record（如
record Box<t>(T value)</t>）的TypeParameter在RecordComponent中不保留具体类型实参，asType()返回的是T符号类型，需结合Types#erasure()或额外元数据推断 - 若项目启用
--enable-preview或多版本 jar，Processor 必须声明支持对应 source version（SupportedSourceVersion(SourceVersion.RELEASE_21)），否则RECORD元素可能被忽略
最易被忽略的一点：record 的 canonical constructor 可能被显式重写（哪怕只加个 throws），此时 getEnclosedElements() 里找不到 CONSTRUCTOR，所有基于构造器参数顺序推导字段校验位置的逻辑都会失效——得退回到字段声明顺序 + 名称匹配。
