@AliasFor 是 Spring 5.2 引入的注解，用于声明属性双向别名关系，支持同名覆盖与属性映射；可在同一注解内互设别名、继承元注解属性、统一组合注解配置，要求类型及默认值一致且必须成对或明确指定 annotation 和 attribute。
@AliasFor 是 Spring 5.2 引入的核心注解，用于在自定义注解中声明属性之间的双向别名关系，支持“同名覆盖”和“属性映射”，常用于简化注解用法或兼容旧属性名。它本身不直接实现“覆盖”，而是让多个属性指向同一语义值，从而在元注解或组合注解场景下，使 Spring 容器能正确解析并统一处理。
一、基础用法：同一注解内属性互为别名
最常见的是在自定义注解中，让 value() 和另一个属性（如 name()）互为别名，避免重复指定：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyMapping {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
}
这样使用时二者等价：
-
@MyMapping("api/v1")→value="api/v1" -
@MyMapping(name = "api/v1")→name="api/v1"，自动同步到value
注意：必须成对声明，且类型相同；若只写一个 @AliasFor，会报编译错误。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
二、继承元注解：覆盖父注解的属性语义
当自定义注解标注了其他 Spring 注解（如 @RequestMapping），可用 @AliasFor 将本注解属性映射到元注解对应字段，实现“语义覆盖”：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@RequestMapping // 元注解
public @interface GetApi {
@AliasFor(annotation = RequestMapping.class, attribute = "path")
String value() default "";
@AliasFor(annotation = RequestMapping.class, attribute = "method")
RequestMethod[] method() default {RequestMethod.GET};
}
此时：
-
@GetApi("/user")等价于@RequestMapping(path = "/user", method = GET) - Spring 解析
@GetApi时，会把value值注入到RequestMapping.path，完成属性桥接
三、组合注解中统一配置入口
多个注解组合时，可通过 @AliasFor 统一暴露配置点，避免用户重复写相同值：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
@EnableAsync
public @interface EnableMyAsync {
@AliasFor(annotation = EnableAsync.class, attribute = "proxyTargetClass")
boolean proxyTargetClass() default false;
@AliasFor(annotation = EnableAsync.class, attribute = "mode")
AdviceMode mode() default AdviceMode.PROXY;
}
使用者只需在 @EnableMyAsync 上设置一次 proxyTargetClass，就同时控制了底层 @EnableAsync 的行为，无需再单独配置原注解。
四、注意事项与限制
- 别名属性必须类型一致、默认值一致（或至少兼容），否则运行时报
AnnotationConfigurationException - 不能跨不同注解层级做单向映射（比如只映射 A→B，却不声明 B→A），必须双向或明确指定
annotation+attribute - Spring Boot 自带注解（如
@SpringBootApplication）大量使用@AliasFor实现属性透传，可参考其源码理解设计意图 - 反射读取时，Spring 的
AnnotationUtils和AnnotatedElementUtils会自动处理别名逻辑，普通反射（getAnnotation()）不会自动同步值
