注解的default属性是编译期常量，默认值非null，用于简化使用；如@value("${x:3000}")、@transactional中propagation=required等均依赖此机制提升易用性。
注解的属性默认值（default）是指在定义注解时，为某个属性预先指定一个固定返回值；当使用者使用该注解但未显式传入该属性时，框架或运行环境会自动采用这个默认值。它不是“空”或“null”，而是明确声明的、类型兼容的常量表达式，比如字符串字面量、基本类型字面量、枚举常量，或Annotation.class等。
default 值的本质与限制
它是注解定义的一部分，写在@interface内部，语法形如：String value() default "default";。关键点包括：
- 每个属性最多只能有一个
default，且必须是编译期常量 - 若某属性声明了
default，使用者可完全省略该属性赋值，注解仍合法 - 若某属性没设
default，又没在使用时提供值，则编译报错 - 不能用
null作为default值（除Class类型可用Void.class等模拟）
@Value 注解中默认值最典型的应用
Spring 的@Value大量依赖default机制解决配置缺失问题。例如：
@Value("${user.timeout:3000}") private int timeout;
这里:3000就是占位符的默认值，并非注解本身的default，但它底层复用了 Java 注解默认值的设计思想——通过语法糖把“未配置”映射为“有兜底”。实际开发中：
- 避免因漏配
application.yml导致启动失败 - 让开发环境用宽松值（如
5000），生产环境覆盖为严格值（如1000） - 对布尔型开关字段，常用
${feature.enabled:true}表达“默认开启”
框架级注解的默认值如何降低使用门槛
Spring 和 JPA 等主流框架广泛利用default隐藏复杂性：
-
@Transactional中propagation = Propagation.REQUIRED是默认值，90%事务无需写这一行 -
@Query(nativeQuery = false)默认走 JPQL，只有需要写原生 SQL 时才显式设为true -
@Scheduled(fixedDelay = -1)这类负值默认表示“不启用”，比强制要求填正数更安全
自定义注解时合理设计 default 的实践建议
当你自己写注解时，default 不是可有可无的装饰，而是 API 友好度的关键：
- 对必填语义强的属性（如
value()），可不设 default，强制使用者明确意图 - 对可选控制项（如
logLevel()、retryTimes()），应设符合常规预期的 default，比如Level.INFO或3 - 避免设容易引发误解的 default，例如
timeout = 0可能被理解为“不限制”，实际常表示“立即超时” - 文档中需清晰说明每个 default 的业务含义，而不仅是技术值
