SpringBoot中@Value和@ConfigurationProperties有哪些不同之处？

2026-05-26 00:231阅读0评论SEO资源

内容介绍
文章标签
相关推荐

本文共计955个文字，预计阅读时间需要4分钟。

SpringBoot中@Value和@ConfigurationProperties有哪些不同之处？

@Value和@ConfigurationProperties注解都可以读取配置文件中的属性值，并将其绑定到JavaBean中，但它们存在以下不同：

- 使用位置不同：@ConfigurationProperties注解直接写在JavaBean的类名上，而@Value注解写在属性上。- 读取配置文件的方式不同：@ConfigurationProperties通过指定前缀来读取配置文件中的属性，而@Value直接指定属性名。

直接输出结果：@Value和@ConfigurationProperties都能读取配置文件中的属性值，并绑定到JavaBean中，但它们存在以下不同。区别在于使用位置和读取配置文件的方式不同。

@Value 和 @ConfigurationProperties 注解都能读取配置文件中的属性值并绑定到 JavaBean 中，但两者存在以下不同。

区别@ConfigurationProperties@Value使用位置不同标注在 JavaBean 的类名上标注在 JavaBean 的属性上功能不同用于批量绑定配置文件中的配置单值绑定松散绑定（松散语法）支持部分支持Spel不支持支持复杂类型封装支持支持，比较繁琐JSR303数据校验支持不支持应用场景不同通过JavaBean获取整个配置文件单个属性值

说明

使用位置不同

@ConfigurationProperties：标注在 JavaBean 的类名上；
@Value：标注在 JavaBean 的属性上。

@Component @Data @ConfigurationProperties(prefix = "person") @PropertySource("classpath:person.properties") public class Person { private String firstName; }

@Component @Data @PropertySource("classpath:user.properties") public class User { @Value("${user.username}") private String username; }

功能不同

@ConfigurationProperties：用于批量绑定配置文件中的配置；
@Value：只能一个一个的指定需要绑定的配置。

松散绑定支持不同

@ConfigurationProperties：支持松散绑定（松散语法），例如实体类 Person 中有一个属性为 firstName，那么配置文件中的属性名支持以下写法：

person.firstName
person.first-name
person.first_name
PERSON.FIRST_NAME

@Vaule：不支持松散绑定。

SpEL 支持不同

SpEL表达式:#{obj}

@ConfigurationProperties：不支持 SpEL 表达式;
@Value：支持 SpEL 表达式。

@Value("#{${girl.hobbyMap}}") private Map<String,Object> hobbyMap;

复杂类型封装

@ConfigurationProperties：支持所有类型数据的封装，例如 Map、List、Set、以及对象等；
@Value：支持基本数据类型的封装，例如字符串、布尔值、整数等类型, 对集合Map list set配置有要求

属性校验

@Value不支持属性校验
@ConfigurationProperties 支持属性校验

@Configuration @ConfigurationProperties(prefix = "boy") @Data @PropertySource("classpath:boy.properties") @Validated public class Boy { @NotNull//不为空 private String name; @Min(20)//不小于20 private int age; }

应用场景不同

@Value 和 @ConfigurationProperties 两个注解之间，并没有明显的优劣之分，它们只是适合的应用场景不同而已。

若只是获取配置文件中的某项值，则推荐使用 @Value 注解；
若专门编写了一个 JavaBean 来和配置文件进行映射，则建议使用 @ConfigurationProperties 注解。

在选用时，根据实际应用场景选择合适的注解能达到事半功倍的效果。

到此这篇关于SpringBoot@Value与@ConfigurationProperties二者有哪些区别的文章就介绍到这了,更多相关SpringBoot@Value与@ConfigurationProperties内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联！

标签：SpringBoot value 与 Configura