spring boot 通过类型匹配、单位注解和自动转换机制精准读取配置数值与时间单位：基础类型（int/boolean等）用@value直接绑定；duration配合@durationunit明确时间语义；datasize配合@datasizeunit处理文件大小；推荐@configurationproperties实现类型安全、校验与ide支持。
数值类型：直接绑定基础类型即可
整数、浮点数、布尔值等纯量类型，Spring Boot 默认支持自动转换：
-
application.yml 中写：
timeout: 30、retry.max-attempts: 5、enable-cache: true -
Java 类中接收：
@Value("${timeout}") private int timeout;或@Value("${enable-cache}") private boolean enableCache; - 若配置缺失，可用冒号加默认值：
@Value("${timeout:60}") private int timeout; - 注意：
@Value只适用于被 Spring 管理的 Bean（如@Component、@Service），且不支持静态字段。
时间单位：用 Duration + @DurationUnit 注解
单纯写 session-timeout: 30 很容易让人困惑——是 30 秒？30 分钟？还是 30 毫秒？Spring Boot 提供了 java.time.Duration 类型配合 @DurationUnit 明确语义：
-
接收类字段声明为：
private Duration sessionTimeout; -
加上单位注解：
@DurationUnit(ChronoUnit.MINUTES)（表示配置里填的数字单位是“分钟”） -
配置文件中只需写数字：
session-timeout: 30→ 自动解析为P30M（30 分钟） - 支持单位包括：
ChronoUnit.MILLIS、SECONDS、MINUTES、HOURS、DAYS，甚至WEEKS、MONTHS、YEARS - 搭配
@ConfigurationProperties更推荐，例如：@ConfigurationProperties(prefix = "app")+@DurationUnit(ChronoUnit.SECONDS)
文件大小单位：用 DataSize + @DataSizeUnit 注解
类似时间，文件大小也常需明确单位（比如缓冲区大小、上传限制）：
-
字段类型改为：
private DataSize maxUploadSize; -
指定单位：
@DataSizeUnit(DataUnit.MB)（表示配置中数字单位是 MB） -
配置示例：
max-upload-size: 10→ 解析为10MB；也可写带单位的字符串：max-upload-size: 2GB（Spring Boot 会自动识别） - 支持单位：
DataUnit.BYTES、KB、MB、GB、TB - 运行时可通过
maxUploadSize.toBytes()、.toMegabytes()等方法获取具体数值。
推荐实践：优先用 @ConfigurationProperties 替代 @Value
当涉及多个关联配置（如超时、重试、大小限制组合），用 @ConfigurationProperties 更安全、可校验、支持 IDE 提示：
- 定义一个配置类，加
@ConfigurationProperties(prefix = "app.network")和@Component - 字段用
Duration+@DurationUnit、DataSize+@DataSizeUnit、int、boolean等混合声明 - yml 中写：
app.network.timeout: 5、app.network.buffer-size: 8、app.network.unit: MB（配合自定义逻辑） - 启动时若单位值非法（如
timeout: abc），会直接报错，比运行时 NPE 更早暴露问题。
