Java注解属性允许基本类型（如int、boolean），因其在编译期作为常量处理；但禁止包装类（如Integer），因注解不支持运行时装箱，且要求所有默认值为编译期常量。
Java 注解属性不支持基本类型，只接受包装类、String、Class、枚举、注解类型，以及它们的一维数组。所以不能直接写 int timeout()，而必须用 Integer timeout() 或更推荐的 int timeout()——等等，这里有个关键点：看似是基本类型，实则编译器会自动按规范处理。
注解中允许的属性类型范围
根据 Java 语言规范，注解的成员（即属性）只能是以下类型之一：
- 所有基本数据类型（
int、boolean、char等）——注意：这是特例，语法上允许写基本类型，但底层仍按常量处理 String-
Class及其限定形式（如Class<?>） - 枚举类型
- 另一个注解类型
- 以上任意类型的一维数组（如
String[]、int[]、MyAnno[]）
⚠️ 不允许：自定义类、泛型类（如 List<String>）、多维数组、包装类的非字面量表达式（如 new Integer(1)）。
为什么能写 int 却不能写 Integer？
表面上看矛盾，实则源于注解的限制机制：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
-
int timeout() default 10;✅ 合法 —— 基本类型是显式允许的，且默认值必须是编译期常量 -
Integer timeout() default 10;❌ 编译错误 ——Integer是引用类型，无法作为注解成员；即使10会自动装箱，但注解解析发生在编译期，不触发运行时装箱机制 -
int timeout() default Integer.MAX_VALUE;✅ 合法 ——Integer.MAX_VALUE是编译期常量 -
int timeout() default getValue();❌ 错误 —— 方法调用不是编译期常量
字符串与 Class 类型的典型用法
这两类最常用，也最安全：
-
String value() default "";—— 默认空字符串，可传任意字面量：@MyAnno("hello") -
Class<?> service() default Object.class;—— 注意必须用.class字面量，不能传实例或字符串 -
MyEnum mode() default MyEnum.NORMAL;—— 枚举值必须是该枚举的显式常量 -
String[] roles() default {"USER", "GUEST"};—— 数组需用花括号，元素为合法字面量
避免常见陷阱
实际开发中容易踩坑的地方：
- 别试图在注解里传对象实例（如
new Date()、Arrays.asList(...)），全部不合法 - 不要混淆“装箱”概念：注解不参与自动装箱/拆箱，
Integer就是不允许的类型，哪怕它和int语义等价 - 数组默认值若为空，写
default {}（空数组），而不是default null（null 不被允许） - 自定义注解若含
Class属性，使用时务必确保类在编译期存在，否则会导致注解处理失败
