java 16+ 的模式匹配不暴露 record component 注解，必须通过 record.getrecordcomponents() 获取 recordcomponent 数组，再调用 getannotation() 等方法提取运行时保留的注解；模式变量无反射信息，getdeclaredfields() 不适用。
Java 16+ 的模式匹配（如 instanceof 模式匹配）本身不直接暴露 Record Component 的注解信息；它只是语法糖，编译后仍依赖 Record 的规范结构。要获取 Record Component 上的注解，必须绕过模式匹配，**通过反射访问 Record 的 component（即 accessor 方法或 getRecordComponents()）**。
用 Record.getRecordComponents() 获取带注解的组件
这是最标准、推荐的方式。Record 类型在运行时提供 getRecordComponents() 方法，返回 RecordComponent 数组，每个对象封装了名称、类型、泛型签名和**直接声明在该 component 上的注解**。
-
RecordComponent.getAnnotations()：获取所有**运行时保留（@Retention(RUNTIME)）且未被元注解@Inherited影响**的注解（注意：@Inherited对 field/component 注解无效，仅对 class 有效） -
RecordComponent.getAnnotation(Class<t>)</t>：按类型查找单个注解 -
RecordComponent.getAnnotatedType()：可进一步获取该 component 类型上的注解（如@NonNull在泛型参数上）
不要试图从模式变量或解构后的局部变量反推注解
模式匹配（例如 if (obj instanceof Person(String name, int age)) { ... }）生成的 name 和 age 是普通局部变量，**没有运行时类型信息或注解关联**。JVM 不为这些变量保留任何元数据。试图对它们调用 getClass().getDeclaredFields() 或类似操作是无效的——它们不是字段，也不对应任何成员。
换句话说：模式变量 ≠ Record component 字段，它只是编译器生成的绑定变量，不具备反射能力。
示例：正确获取注解的代码片段
假设定义了一个带注解的 Record：
@Target(ElementType.RECORD_COMPONENT) @Retention(RetentionPolicy.RUNTIME)
@interface Valid {}
record Person(@Valid String name, int age) {}
获取注解的可靠方式是：
Person p = new Person("Alice", 30);
RecordComponent[] components = p.getClass().getRecordComponents();
for (RecordComponent rc : components) {
if (rc.getName().equals("name")) {
Valid valid = rc.getAnnotation(Valid.class); // ✅ 正确拿到 @Valid
System.out.println(valid); // non-null
}
}
补充说明：为什么不能用 getDeclaredFields()？
Record 的私有 final 字段（如 private final String name;）虽然存在，但其上的注解**不会自动继承到 component 上**。Java 规范要求：只有显式标注在 record component（即构造函数参数位置）的注解，才可通过 RecordComponent 获取。字段上重复标注的注解属于冗余，且 getDeclaredFields() 返回的 Field 对象调用 getAnnotation() 通常返回 null（除非你真在字段上写了，但这违背 Record 设计意图）。
不复杂但容易忽略：模式匹配是语法便利，注解元数据只活在 RecordComponent 里，反射入口很明确，别走弯路。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
