Java注解属性类型仅限六类：基本类型、String、Class（如Class<?>）、枚举、其他注解及它们的一维数组；禁止普通类、接口、集合、泛型、Object等非法类型。
Java 注解的属性类型有严格限制，不能随意声明任意对象类型。一旦用了不支持的类型（比如普通类、接口、集合、泛型类等），编译器会直接拒绝，报类似 illegal type for annotation member 或 attribute value must be a class literal 的错误。核心在于：注解只允许特定“字面量友好”的类型。
注解属性只支持这六类类型
根据 Java 语言规范，注解中能声明的属性类型仅限以下且仅以下几种：
- 基本类型（
int、boolean、char等） String-
Class（必须是Class<?>或具体类字面量，如String.class） - 枚举类型（需提前定义好枚举类）
- 其他注解类型（即嵌套注解）
- 以上任意类型的**一维数组**（如
String[]、MyAnnotation[]）
❌ 常见非法写法（全部编译失败）：
List<String> values();Map<K, V> config();-
UserService service();（普通 Bean 类） -
Object data();（Object不在白名单内） -
MyEntity entity();（非注解、非 Class、非枚举）
用 Class 替代实例，运行时再解析
如果想传递某个类的行为或配置意图，不要传对象实例，改用 Class 字面量，把实例化逻辑交给注解处理器或运行时框架。
✅ 正确示例：
@interface Loggable {
Class<? extends LogHandler> handler() default DefaultLogHandler.class;
String[] excludeMethods() default {};
}
使用时写：@Loggable(handler = MyCustomHandler.class)。这样既合法，又保留了扩展性。
复杂结构拆成多个基础属性或嵌套注解
需要表达一组关联配置？别打包成一个 Map 或 DTO 对象，而是拆开或用嵌套注解。
✅ 推荐方式一：拆为多个字符串/枚举/数组属性
@interface Retry {
int maxAttempts() default 3;
long delayMs() default 1000;
String[] retryExceptions() default {};
BackoffPolicy policy() default BackoffPolicy.FIXED;
}
✅ 推荐方式二：用嵌套注解组织逻辑分组
@interface Timeout {
long connect() default 5000;
long read() default 10000;
}
@interface ApiConfig {
String baseUrl();
Timeout timeout() default @Timeout(connect = 3000);
}
避免注解间相互引用形成循环
两个注解若互为对方的属性类型（A 含 B，B 含 A），编译器会报 cyclic annotation element type 错误。
✅ 解法：引入中间标识（如 String 名称或 Class 类型），由处理器统一解析；或合并为一个更通用的注解，用枚举区分场景。
例如不用：
@interface A { B b(); }
@interface B { A a(); } // ❌ 编译失败
改用：
@interface A { String bType(); }
@interface B { String aType(); } // ✅ 合法，语义由处理器约定 
