@Value适合单个值快速注入，@ConfigurationProperties适合结构化、可校验、可复用的配置对象绑定；前者依赖Spring Bean且不支持静态字段和校验，后者需注册为Bean、支持松散绑定、嵌套类型及JSR-303校验。
Spring Boot 读取配置主要靠 @Value 和 @ConfigurationProperties，但它们定位不同：前者适合单个值的快速注入，后者适合结构化、可校验、可复用的配置对象绑定。
@Value 注入：简单直接，适合零散配置
它通过表达式语法 ${key} 从 Spring Environment 中取值，支持 SpEL（#{...}），常用于注入开关、超时、路径等独立参数。
- 必须用在 Spring 管理的 Bean 上（如加了
@Component、@Service的类），否则字段为null - 不支持静态字段（
static）、final字段、局部变量或构造器参数 - 字段名和配置 key 无关，只看表达式里的 key 是否拼写正确（区分大小写）
- 支持数组和集合注入，例如：
@Value("${tools}") private String[] tools;，默认按逗号分割 - 无法做嵌套对象绑定，也不能配合
@Validated做校验
@ConfigurationProperties 注入：面向对象，适合批量结构化配置
它把一段前缀下的所有配置项自动绑定到一个 Java 类的实例上，本质是“配置即对象”，天然支持嵌套、集合、类型转换和 JSR-303 校验。
- 类需有标准 getter/setter（绑定靠 setter 方法，不是反射设字段）
- 必须让该类成为 Spring Bean，方式有三种：
@Component扫描、@EnableConfigurationProperties显式启用、或@ConfigurationPropertiesScan包扫描 - 支持松散绑定：配置中写
user-name或userName，都能映射到userName字段 - 可在字段上加
@NotBlank、@Min等注解，并搭配@Validated开启校验 - 支持复杂类型，比如
Map<String, String>、List<ServerConfig>，只要对应类也标注@ConfigurationProperties
关键区别与选型建议
不是“哪个更好”，而是“用对地方”：
- 只读一个值（如
app.debug=true）→ 用@Value - 有一组相关配置（如数据库连接、短信 SDK 参数、第三方服务地址）→ 用
@ConfigurationProperties - 需要校验（如邮箱格式、端口范围）或 IDE 提示、配置元数据（
spring-configuration-metadata.json）→ 必选@ConfigurationProperties - 想在非 Spring Bean 类里读配置？不行——两者都依赖容器管理；此时应改用
Environment手动获取
常见失效原因
配置写了却没注入，多数不是语法错，而是环境或生命周期问题：
-
@Value为空：检查类是否被 Spring 扫描到（加@Component）、是否用了new创建而非注入 -
@ConfigurationProperties字段为null：确认类已注册为 Bean，且 prefix 完全匹配（如prefix = "aliyun.sms"对应aliyun.sms.access-key） - IDE 报红“Configuration Annotation Processor not configured”：Maven 项目需添加
spring-boot-configuration-processor依赖，启用注解处理器生成元数据 - 配置未生效：检查 profile 是否匹配（
application-dev.yml在非 dev 环境下不加载）、文件名是否为application.yml或application.properties
