SynthesizedAnnotation 是 Spring 内部动态生成的代理对象，用于高效合成组合注解中通过 @AliasFor 映射的元注解属性，支持多层注解穿透与统一视图，由 AnnotatedElementUtils 等工具自动创建，用户无需手动实例化。
Spring Core 中的 SynthesizedAnnotation 并非用户直接使用的 API，而是 Spring 内部用于**高效合成（synthesize）组合注解（composed annotations）** 的机制。它不负责“隐式元注解”的定义，而是支撑你在使用 @AliasFor、@Repeatable 或组合注解（如 @RestController）时，让 Spring 能正确读取被元注解（meta-annotations）修饰的属性值 —— 尤其是当这些元注解本身也带有 @AliasFor 时。
组合注解与元注解的关系是基础
组合注解（如 @Service）本身用 @Component 标记，@Component 就是它的元注解。Spring 在解析 @Service 时，需要“穿透”到 @Component 获取其语义（比如注册为 bean）。这个穿透过程依赖的是 Spring 的 注解元数据解析器（AnnotationUtils、AnnotatedElementUtils），而非手动构造 SynthesizedAnnotation。
-
@Component是@Service的元注解，但@Component本身没有@AliasFor，所以属性不继承也不重映射 - 真正需要“合成”的场景是：组合注解中用
@AliasFor映射元注解的属性（例如自定义@MyApi映射@RequestMapping的path） - 此时 Spring 需把多个层级的注解“合并视图”，形成一个逻辑上统一的注解实例 —— 这就是
SynthesizedAnnotation所在的位置
SynthesizedAnnotation 是运行时合成结果，不是你写的类
你不会也不该自己 new 一个 SynthesizedAnnotation。它是 Spring 在调用 AnnotatedElementUtils.findMergedAnnotation(...) 或 AnnotationUtils.synthesizeAnnotation(...) 时，由 StandardAnnotationMetadata 或 SynthesizedAnnotatedElement 内部动态生成的代理对象。
- 它实现了目标注解类型（如
RequestMapping.class）的接口，并重写所有方法，按优先级（就近原则 +@AliasFor规则）返回实际值 - 底层使用
java.lang.reflect.Proxy和InvocationHandler实现，屏蔽了多层元注解的查找逻辑 - 例如：访问
synthesized.getMapping().path()，实际可能从@MyApi的value()字段 +@AliasFor映射而来
要让组合注解支持隐式元注解属性，关键在声明方式
“隐式元注解”不是自动发生的，必须显式通过 @AliasFor 建立属性桥接。Spring 会据此触发合成逻辑：
立即学习“Java免费学习笔记（深入）”；
- 在组合注解中，用
@AliasFor(annotation = Xxx.class, attribute = "xxx")明确指向元注解的某个属性 - 确保元注解本身可被反射读取（不能是
@Retention(RetentionPolicy.SOURCE)） - 避免循环别名或歧义映射（如两个
@AliasFor指向同一属性但来源冲突） - 示例：
@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @RequestMapping // 元注解 public @interface MyApi { @AliasFor(annotation = RequestMapping.class, attribute = "path") String value() default ""; <pre class="brush:php;toolbar:false;">@AliasFor(annotation = RequestMapping.class, attribute = "method") RequestMethod[] method() default {};}
验证是否生效：用 AnnotatedElementUtils 替代 getAnnotation
直接调用 clazz.getAnnotation(MyApi.class) 只能拿到原始注解实例，无法体现元注解属性的合成效果。必须用 Spring 提供的工具：
-
AnnotatedElementUtils.findMergedAnnotation(clazz, RequestMapping.class)→ 返回合成后的RequestMapping实例 -
AnnotationUtils.synthesizeAnnotation(attrsMap, RequestMapping.class, source)→ 手动合成（测试/高级场景用） - 内部已自动使用
SynthesizedAnnotation，你只需关心输入和输出语义
不复杂但容易忽略：组合注解的“隐式能力”来自 Spring 注解基础设施的深度集成，而不是某一个类的魔法。写好 @AliasFor，用对 AnnotatedElementUtils，合成就自然发生。
