复合注解通过元注解组合实现语义继承与属性桥接，如@Service本质是@Component的组合；需正确声明@Target、@Retention等JDK元注解，并用@AliasFor桥接属性，确保Spring容器识别并执行全部语义。
直接用元注解组合出复合注解，核心是让一个自定义注解“携带并激活”多个基础注解的行为，而不是简单堆砌。Spring 本身大量使用这种方式（比如 @Service 本质是 @Component 的组合），关键在于理解“语义继承”和“属性桥接”。
明确目标：你要组合哪些语义？
先想清楚你希望这个复合注解承担什么职责。常见组合方向有：
-
配置类简化：把
@Configuration + @ComponentScan合成一个，如@AppConfig("com.example") -
切面统一启用：把
@EnableAspectJAutoProxy + @Import(MyAspectConfig.class)封装为@EnableMyTracing -
条件化 Bean 注册：把
@ConditionalOnProperty + @Configuration组合成@ConditionalOnFeature("payment") -
测试环境快捷配置：把
@TestConfiguration + @Import(TestDataSourceConfig.class)合成@TestSupport
正确声明元注解：不只是加几个 @interface
必须显式标注 JDK 元注解，并合理复用 Spring 提供的元能力：
-
@Target(ElementType.TYPE)：限定只能用在类上（若需支持方法或参数，需补充其他 ElementType） -
@Retention(RetentionPolicy.RUNTIME)：确保运行时可通过反射读取 -
@Documented：让 Javadoc 显示该注解（可选但推荐） -
@Configuration、@ComponentScan等 Spring 注解本身已是元注解，直接写在你的接口上即可生效 -
关键细节：若被组合的注解有
value()属性（如@ComponentScan），你的复合注解也必须声明同名value()，且默认值一致（如String[] value() default {};），否则 Spring 无法自动桥接参数
处理属性传递与覆盖
复合注解不是黑盒，它需要把使用者传入的参数准确“转发”给内部组合的注解：
- 如果只组合
@Configuration和@ComponentScan，且都依赖value指定包路径，那只需一个value()即可满足双方 - 若要分别控制扫描路径和配置类行为，就需定义不同命名属性（如
basePackages()和proxyBeanMethods()），再通过@AliasFor显式绑定到对应元注解的属性上 - 例如：
@AliasFor(annotation = ComponentScan.class, attribute = "basePackages") String[] scanBasePackages() default {};
验证是否真正生效
不能只看编译通过——要确认 Spring 容器确实识别并执行了所有组合语义：
- 启动应用后检查日志，确认组件扫描是否命中你预期的包（如 “Scanning for components in package [com.example]”）
- 调试时进入
AnnotatedElementUtils.findMergedAnnotation()，观察是否能从你的复合注解上“展开”出@Configuration和@ComponentScan - 写一个简单
@Service类放在被扫描包下，尝试context.getBean()成功获取，证明扫描+配置双重逻辑已就位
