注解参数类型受限是Java语言规范强制要求，仅允许基本类型、String、枚举、注解及它们的一维数组；因字节码常量池无法存储复杂对象，且泛型擦除使运行时类型信息丢失。
注解的参数类型受限，是因为 Java 规范在设计时就明确限定了注解成员（annotation members）只能使用特定类型的值——这是编译期检查的硬性要求，不是框架或工具的限制。
Java 语言规范强制约束
根据 Java 语言规范（JLS §9.6.1），注解中定义的元素（即方法声明）返回类型只能是以下之一：
- 基本类型（byte、short、int、long、float、double、boolean、char）
- String
- 枚举类型（enum）
- 注解类型（即嵌套注解）
- 以上类型的**一维数组**（如 String[]、MyEnum[]）
不允许使用 Object、List、Map、自定义类、包装类（如 Integer）等——哪怕它们在运行时能装箱，编译器仍会报错，因为注解信息需在编译期固化为字节码中的常量池项，而 JVM 只允许常量池存基本常量、字符串、类/字段/方法引用等有限结构。
字节码层面无法存储复杂对象
注解实际被编译进 class 文件的 RuntimeVisibleAnnotations 属性中。该属性只支持写入“可直接序列化为常量”的值，比如：
- 42 → 存为 Integer 常量
- "hello" → 存为 UTF8 常量
- MyEnum.VALUE → 存为枚举类名 + 枚举常量名两个字符串引用
但像 new ArrayList
泛型与运行时擦除进一步限制表达能力
即使绕过编译检查（比如用反射强行设置），也无法解决本质问题：Java 泛型在运行时被擦除，List
替代方案其实很清晰
若需传递结构化数据，推荐组合使用：
- 用 String 存 JSON（如
@MyAnno(config = "{\"timeout\":3000,\"retries\":3}")），再在处理逻辑中解析 - 拆分为多个基础类型参数（如
@MyAnno(timeout = 3000, retries = 3)） - 定义专用枚举覆盖常见取值（如
Level.DEBUG、Mode.STRICT） - 嵌套注解表达一组关联配置（如
@Retry(maxAttempts = 3, delayMs = 100)）
这些方式既符合规范，又保持了编译安全和工具链兼容性。
