一、核心定义与基础用法1. Value 注解Value是 Spring 中用于零散地、直接地注入单个配置值的注解支持 SpEL 表达式Spring 表达式语言通常作用在字段、方法参数或构造器参数上。java运行Component public class ValueDemo { // 注入单个配置值 Value(${app.name}) private String appName; // 支持默认值 Value(${app.port:8080}) private Integer appPort; // 支持SpEL表达式 Value(#{T(java.lang.Math).random() * 100}) private Double randomNum; }2. ConfigurationProperties 注解ConfigurationProperties是 Spring Boot 提供的注解用于批量地、结构化地绑定一组相关的配置属性到一个 Java 类中通常作用在类上需要配合Component或Configuration使类被 Spring 管理。java运行Component // 绑定配置前缀为app的所有属性 ConfigurationProperties(prefix app) public class ConfigPropertiesDemo { private String name; private Integer port; private ListString allowedIps; // 支持复杂类型集合、对象 // 必须提供getter/setter方法核心 public String getName() { return name; } public void setName(String name) { this.name name; } public Integer getPort() { return port; } public void setPort(Integer port) { this.port port; } public ListString getAllowedIps() { return allowedIps; } public void setAllowedIps(ListString allowedIps) { this.allowedIps allowedIps; } }对应的application.yml配置yamlapp: name: demo-app port: 8081 allowed-ips: [127.0.0.1, 192.168.1.1]二、核心对比笔记核心对比维度Value 注解ConfigurationProperties 注解绑定方式单个属性零散绑定批量结构化绑定按前缀分组支持的数据类型基本类型、String、SpEL 表达式基本类型、String、集合、对象嵌套是否需要 getter/setter不需要直接注入字段必须需要通过 setter 绑定默认值支持支持如${key:默认值}不直接支持需在类中手动设置默认值SpEL 表达式支持支持不支持配置校验不支持无法用 Validated 等校验支持配合 Validated、NotNull 等松散绑定不支持必须严格匹配配置名如 appName 不能写 app-name支持app-name 可绑定到 appName 字段IDE 提示无IDE 无法识别配置键是否存在有Spring Boot 插件可提示配置键使用场景少量、零散的配置注入一组相关的配置如数据源、第三方服务配置三、实战示例配置校验ConfigurationProperties 独有java运行Component ConfigurationProperties(prefix app) Validated // 开启校验 public class ValidConfigDemo { NotNull(message 应用名称不能为空) // 校验规则 private String name; Min(value 1024, message 端口号不能小于1024) private Integer port; // getter/setter省略 }当配置中app.name为空时启动项目会直接抛出校验异常提前发现配置错误这是Value做不到的。四、使用建议如果只是注入 1-2 个零散的配置如单个端口、单个开关用Value更简洁如果是一组相关的配置如数据库配置url、username、password优先用ConfigurationProperties可读性和可维护性更高对配置有校验需求、需要 IDE 提示、或配置包含集合 / 对象类型时必须用ConfigurationProperties避免混合使用同一组配置要么全用Value要么全用ConfigurationProperties保持风格统一。总结Value适合零散、简单、需 SpEL的配置注入无需 getter/setter但不支持校验和松散绑定ConfigurationProperties适合批量、结构化、需校验的配置注入支持复杂类型和松散绑定是 Spring Boot 中管理配置的最佳实践核心选择依据配置的 “关联性” 和 “复杂度”—— 零散简单用Value成组复杂用ConfigurationProperties。