解讀@ConfigurationProperties和@value的區(qū)別
更新時間：2025年05月23日 11:12:17 作者：codingPower
這篇文章主要介紹了@ConfigurationProperties和@value的區(qū)別及說明,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
在 Spring Boot 中，@ConfigurationProperties 和 @Value 都是用于注入配置值的注解，但它們的設(shè)計目標、使用場景和功能有顯著差異。
以下是它們的核心區(qū)別和適用場景：
1. 功能對比
| 特性 | @ConfigurationProperties | @Value |
|---|---|---|
| 作用范圍 | 批量綁定配置文件中的 一組相關(guān)屬性 到 Bean 的字段。 | 注入 單個屬性值 到字段或參數(shù)。 |
| 松散綁定 | 支持松散綁定（如 myProp、my-prop、MY_PROP）。 | 不支持，屬性名必須嚴格匹配。 |
| 類型安全 | 基于 類型安全的配置綁定（字段類型自動轉(zhuǎn)換）。 | 需要手動處理類型轉(zhuǎn)換，如 @Value("${port}") int port。 |
| SpEL 表達式 | 不支持 SpEL 表達式。 | 支持 SpEL 表達式（如 @Value("#{systemProperties['user']}")）。 |
| 默認值 | 通過字段初始化設(shè)置默認值（如 private String name = "default";）。 | 可在占位符中指定默認值（如 @Value("${name:default}")）。 |
| 驗證支持 | 支持 JSR-303 驗證（如 @NotNull、@Size）。 | 不支持 驗證注解。 |
| 復雜對象綁定 | 支持嵌套對象、集合、Map 等復雜結(jié)構(gòu)的綁定。 | 僅支持簡單類型（需手動拆分復雜結(jié)構(gòu)）。 |
2. 使用場景對比
@ConfigurationProperties
適用場景：
- 需要將 一組相關(guān)的配置屬性 綁定到一個對象（如數(shù)據(jù)庫配置、第三方服務配置）。
- 需要類型安全、自動轉(zhuǎn)換和松散綁定。
- 需要支持嵌套對象或集合類型（如
List、Map）。
示例一：
// 配置類定義
@Component
@ConfigurationProperties(prefix = "app.datasource")
public class DataSourceConfig {
private String url;
private String username;
private int maxPoolSize;
// Getters and Setters
}
// 業(yè)務類調(diào)用
@Service
public class DataSourceService {
@Autowired
private DataSourceConfig dataConfig; // 直接注入配置對象
public void connect() {
System.out.println("Connecting to: " + dataConfig.getUrl() + ":" + dataConfig.getUsername());
}
}
對應 application.properties
# application.properties app.datasource.url=jdbc:mysql://localhost:3306/db app.datasource.username=power app.datasource.max-pool-size=10
對應 application.yml：
app:
datasource:
url: jdbc:mysql://localhost:3306/db
username: power
maxPoolSize: 10
示例二：
- 通過 @EnableConfigurationProperties 顯式啟用
步驟：
- 在配置類或主啟動類上使用 @EnableConfigurationProperties 注解，手動注冊配置類14。
- 通過構(gòu)造函數(shù)或 @Autowired 注入配置對象。
代碼示例：
/ 配置類定義（無需 @Component）
@ConfigurationProperties(prefix = "app.mail")
public class MailConfig {
private String host;
private int port;
// getter/setter
}
// 主啟動類顯式啟用
@SpringBootApplication
@EnableConfigurationProperties(MailConfig.class)
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
// 業(yè)務類調(diào)用（構(gòu)造器注入）
@Service
public class MailService {
private final MailConfig mailConfig;
public MailService(MailConfig mailConfig) {
this.mailConfig = mailConfig;
}
}@Value
適用場景：
- 注入 單個簡單值（如開關(guān)標志、端口號）。
- 需要動態(tài)計算值（使用 SpEL 表達式）。
- 臨時調(diào)試或快速原型開發(fā)。
示例：
@Component
public class MyService {
@Value("${app.feature.enabled:false}")
private boolean featureEnabled;
@Value("#{systemProperties['user.timezone']}")
private String timezone;
}3. 核心區(qū)別詳解
(1) 類型安全與松散綁定
@ConfigurationProperties：
- 自動將配置文件中的屬性轉(zhuǎn)換為字段類型（如
String→int、List）。 - 支持松散綁定（屬性名不嚴格匹配），例如
myProp、my-prop、MY_PROP都會匹配到字段myProp。
@Value：
- 需要手動處理類型轉(zhuǎn)換（如
@Value("${port}") int port）。 - 屬性名必須嚴格匹配，否則注入失敗。
(2) 復雜對象支持
@ConfigurationProperties：
支持嵌套對象和集合：
app:
servers:
- name: server1
ip: 192.168.1.1
- name: server2
ip: 192.168.1.2@ConfigurationProperties(prefix = "app")
public class AppConfig {
private List<Server> servers;
// Getters and Setters
}@Value：
需要手動拆分復雜結(jié)構(gòu)：
@Value("${app.servers[0].name}")
private String server1Name;(3) 驗證與默認值
@ConfigurationProperties：
結(jié)合 @Validated 實現(xiàn)字段驗證：
@ConfigurationProperties(prefix = "app")
@Validated
public class AppConfig {
@NotNull
private String name;
@Min(1)
private int maxConnections;
}@Value：
直接在占位符中設(shè)置默認值：
@Value("${app.name:DefaultApp}")
private String appName;4. 如何選擇？
| 場景 | 推薦注解 |
|---|---|
| 需要綁定一組相關(guān)配置 | @ConfigurationProperties |
| 需要注入單個簡單值 | @Value |
| 需要支持松散綁定或復雜結(jié)構(gòu) | @ConfigurationProperties |
| 需要使用 SpEL 動態(tài)計算值 | @Value |
| 需要類型安全與 JSR-303 驗證 | @ConfigurationProperties |
總結(jié)
@ConfigurationProperties：
適合 集中管理復雜配置，提供類型安全、松散綁定和驗證支持，是 Spring Boot 推薦的配置注入方式。
@Value：
適合 快速注入簡單值或動態(tài)計算值，靈活性高但缺乏類型安全和批量綁定能力。
根據(jù)實際需求選擇合適的注解，優(yōu)先使用 @ConfigurationProperties 以提高代碼的可維護性和健壯性。
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
您可能感興趣的文章:
- SpringBoot中@Value獲取值和@ConfigurationProperties獲取值用法及比較
- Spring?Boot讀取配置文件內(nèi)容的3種方式(@Value、Environment和@ConfigurationProperties)
- SpringBoot?@Value與@ConfigurationProperties二者有哪些區(qū)別
- springboot如何通過@Value,@ConfigurationProperties獲取配置
- 聊聊@value注解和@ConfigurationProperties注解的使用
- SpringBoot中注解@ConfigurationProperties與@Value的區(qū)別與使用詳解
相關(guān)文章
利用Java中Calendar計算兩個日期之間的天數(shù)和周數(shù)
Java 語言的Calendar(日歷),Date(日期)，和DateFormat(日期格式)組成了Java標準的一個基本但是非常重要的部分。日期是商業(yè)邏輯計算一個關(guān)鍵的部分。下面這篇文章就給大家介紹了如何利用Java中Calendar計算兩個日期之間的天數(shù)和周數(shù)，下面來一起看看吧。2016-12-12
這篇文章主要為大家詳細介紹了Java Robot應用示例之機器人功能，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-01-01
本文主要介紹了k8s部署java項目的實現(xiàn)，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-12-12
Java中實現(xiàn)多線程關(guān)鍵詞整理(總結(jié))
這篇文章主要介紹了Java中實現(xiàn)多線程關(guān)鍵詞整理，非常不錯，具有參考借鑒價值,需要的朋友可以參考下2017-05-05
Struts2返回json格式數(shù)據(jù)代碼實例
這篇文章主要介紹了Struts2返回json格式數(shù)據(jù)代碼實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-04-04
Java在高并發(fā)場景下實現(xiàn)點贊計數(shù)器
點贊計數(shù)器的本質(zhì)就是對某個變量在高并發(fā)情況下的修改，這篇文章主要為大家介紹了Java實現(xiàn)點贊計數(shù)器的示例代碼，感興趣的小伙伴可以了解一下2023-06-06
Java Stream 是一個來自 java.util.stream 包的抽象概念,它允許你以聲明方式處理數(shù)據(jù)集合（例如 List、Set 等）,本文給大家介紹Java Stream流從入門到精通,感興趣的朋友跟隨小編一起看看吧2025-09-09
在油管上看了龍之春的一個Spring tips 視頻，講述Spring外部化配置的幾種技巧，收獲頗多，想拿出來給大家分享下。對spring感興趣的朋友可以了解下本文2021-06-06
這篇文章主要介紹了javaWeb 四大域?qū)ο笤敿毥榻B的相關(guān)資料,需要的朋友可以參考下2016-11-11
這篇文章主要給大家介紹了關(guān)于使用SpringBoot自定義starter的完整步驟，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-10-10