Java注解属性仅支持基本类型、String、Class、枚举、数组及嵌套注解；default值须为编译时常量，优雅实践包括用枚举替代字符串、空数组代替null、布尔值取保守默认等。
在 Java 注解（Annotation）中，声明允许的属性类型和设置优雅的 default 值，核心是遵守 JVM 规范对注解成员的限制，并兼顾可读性、安全性和使用便利性。
一、注解属性只允许特定类型
注解的每个成员（即方法）必须是以下类型之一，否则编译报错：
- 基本类型（
int、boolean、char等）及其包装类（Integer、Boolean等） String-
Class（或带泛型约束的Class<?>） - 枚举类型（
enum） - 以上任意类型的数组（如
String[]、MyEnum[]） - 其他注解类型（嵌套注解）
⚠️ 不支持：集合（List、Map）、泛型类（List<String>）、任意对象、null 字面量（default null 非法）。
二、default 值必须是编译时常量
default 后面的值必须在编译期就能确定，不能是运行时计算结果。常见合法写法：
int value() default 42;String name() default "unknown";Class<?> clazz() default Object.class;MyEnum mode() default MyEnum.AUTO;String[] tags() default {}; // 空数组合法String[] tags() default {"default"};MyAnn ann() default @MyAnn(); // 嵌套注解默认值
❌ 非法示例：default System.currentTimeMillis()、default new String[]{"a"}（非字面量数组初始化）、default null。
三、让 default 更“优雅”的实用技巧
所谓优雅，是指语义清晰、降低误用、便于扩展：
-
用枚举代替字符串字面量：避免拼写错误，IDE 可提示补全。
LogLevel level() default LogLevel.INFO;比String level() default "INFO";更安全。 -
空数组优于
null或特殊字符串：避免调用方判空负担。String[] includes() default {};使用时可直接遍历，无需先判是否为null。 -
用专用注解替代复杂参数组合：比如多个关联字段（host/port/timeout），封装为一个嵌套注解，
default @ServerConfig()比分散定义更内聚。 -
为布尔值选好默认语义：优先选“保守”或“关闭”态作为默认，如
boolean async() default false;、boolean enabled() default true;，符合直觉且减少显式配置。
四、进阶：模拟“可选”与“未设置”语义
注解本身不支持 Optional 或 null，默认值一旦声明就无法区分“用户没填”和“用户填了默认值”。若需这种语义，常用变通方式：
-
用特殊哨兵值：如
int timeout() default -1;，-1 表示“未指定”，业务逻辑中单独处理。 -
拆成两个属性：如
boolean hasTimeout() default false;+int timeoutValue() default 0;，但侵入性强，慎用。 -
依赖处理器逻辑判断：在
AnnotationProcessor或运行时反射中，通过Annotation.getMemberValues()（需反射访问）检测是否为默认值——但非常规手段，仅限高级场景。
多数情况下，设计好默认值语义 + 清晰文档，比强行模拟“未设置”更简单可靠。
