Spring Boot：使用@Value时@ConfigurationProperties前缀为何失效？

结论 #

这是正确行为，并非你的项目配置有误。

原因分析 #

@ConfigurationProperties 和 @Value 是Spring中两套独立的配置绑定机制，彼此没有关联：

• @ConfigurationProperties 是批量绑定：通过指定prefix，自动将配置中对应前缀下的属性与类的字段名映射（比如prefix为inner.system时，字段number会绑定inner.system.number，字段id会绑定inner.system.id），不需要额外注解，只要类有对应的getter/setter（你的代码中@Data已经自动生成）即可生效。
• @Value 是精准读取：直接通过配置键名（SpEL表达式）读取对应配置，它完全不识别@ConfigurationProperties的prefix。当你写@Value("${id}")时，Spring会去查找顶级的id配置项（即YAML中直接写id: xxx），但你的配置里只有inner.system.id，自然找不到，导致加载失败。

正确用法 #

如果想借助@ConfigurationProperties的prefix绑定id，直接移除@Value注解即可，让字段自动匹配前缀下的配置：

@Configuration
@ConfigurationProperties(prefix = "inner.system")
@Slf4j(topic = "Configuration Properties Logger")
@Data
public class ConfigurationProperties {
  private String number;
  private String id; // 自动绑定inner.system.id
}

内容的提问来源于stack exchange，提问作者Serhii