【Spring Boot 中 `@Value` 注解的使用】

---

一、前言

在 Spring Boot 项目中通常需要从 application.properties 或 application.yml 配置文件中读取配置信息。@Value 注解提供了一种简单的方式来将配置值注入到 Spring 组件中。

---

二、@Value 注解简介

@Value 是 Spring 提供的一个注解，用于从配置文件或其他来源（如系统环境变量、SpEL 表达式）中读取值并注入到 Bean 的字段或方法参数中。其基本语法如下：

@Value("${property.key}")
private String propertyValue;

---

三、@Value 注解的常见用法

1. 读取 application.properties 或 application.yml 配置值

（1）配置文件示例

application.properties

app.name=Spring Boot Demo
app.version=1.0.0

application.yml

app:name: Spring Boot Demoversion: 1.0.0

（2）Java 代码示例

@Component
public class AppConfig {@Value("${app.name}")private String appName;@Value("${app.version}")private String appVersion;public void printConfig() {System.out.println("Application Name: " + appName);System.out.println("Application Version: " + appVersion);}
}

（3）测试输出

Application Name: Spring Boot Demo
Application Version: 1.0.0

---

2. 使用 @Value 设置默认值

如果配置文件中未定义某个属性，则 @Value 注解可以提供一个默认值。默认值的语法是 :${defaultValue}：

@Component
public class DefaultValueExample {@Value("${app.author:Unknown Author}")private String author;public void printAuthor() {System.out.println("Application Author: " + author);}
}

如果 application.properties 或 application.yml 中未配置 app.author，则输出：

Application Author: Unknown Author

---

3. 读取系统环境变量和 Java 运行时参数

@Value 也可以用于读取系统环境变量或 -D 方式传递的 JVM 运行参数：

@Component
public class EnvConfig {@Value("${JAVA_HOME}")private String javaHome;@Value("${user.name}")private String userName;public void printSystemProperties() {System.out.println("JAVA_HOME: " + javaHome);System.out.println("User Name: " + userName);}
}

如果运行环境变量设置了 JAVA_HOME=/usr/lib/jvm/java-11-openjdk，则输出：

JAVA_HOME: /usr/lib/jvm/java-11-openjdk
User Name: admin

---

4. 结合 Spring Expression Language (SpEL)

@Value 注解支持 Spring 表达式语言（SpEL），可用于动态计算值。

（1）基本 SpEL 表达式

@Component
public class SpELExample {@Value("#{2 * 5}")private int result;public void printResult() {System.out.println("Result: " + result);}
}

输出：

Result: 10

（2）引用 Bean 的属性

@Component
public class AnotherBean {private String message = "Hello from AnotherBean";public String getMessage() {return message;}
}@Component
public class BeanReferenceExample {@Autowiredprivate AnotherBean anotherBean;@Value("#{anotherBean.message}")private String messageFromAnotherBean;public void printMessage() {System.out.println(messageFromAnotherBean);}
}

输出：

Hello from AnotherBean

---

5. 读取数组、集合和 Map 类型数据

（1）读取数组

app.servers=192.168.1.1,192.168.1.2,192.168.1.3

@Component
public class ArrayConfig {@Value("${app.servers}")private String[] servers;public void printServers() {System.out.println(Arrays.toString(servers));}
}

输出：

[192.168.1.1, 192.168.1.2, 192.168.1.3]

（2）读取 List

@Component
public class ListConfig {@Value("#{'${app.servers}'.split(',')}")private List<String> serverList;public void printServerList() {System.out.println(serverList);}
}

输出：

[192.168.1.1, 192.168.1.2, 192.168.1.3]

（3）读取 Map

app.db.config=username:admin,password:123456,url:jdbc:mysql://localhost:3306/test

@Component
public class MapConfig {@Value("#{${app.db.config}}")private Map<String, String> dbConfig;public void printDbConfig() {System.out.println(dbConfig);}
}

输出：

{username=admin, password=123456, url=jdbc:mysql://localhost:3306/test}

---

四、@Value 和 @ConfigurationProperties 对比

特性	@Value	@ConfigurationProperties
作用范围	适用于单个值注入	适用于整个配置对象映射
支持的数据类型	主要用于 String、基本类型、数组	可绑定复杂对象（如 List、Map、自定义对象）
代码简洁性	适用于少量配置参数	适用于大量配置参数
是否支持 SpEL	支持	不支持

示例：@ConfigurationProperties 用法

app.name=Spring Boot Demo
app.version=1.0.0

@Configuration
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String name;private String version;// getter & setter
}

---

五、总结

• @Value 注解用于将配置文件中的值注入到 Spring 组件中。
• @Value 可用于读取 application.properties 或 application.yml 中的值，并支持默认值。
• @Value 还能用于读取环境变量、JVM 运行参数和 SpEL 表达式。
• @Value 可以解析数组、List、Map 等数据结构。
• 对于复杂配置推荐使用 @ConfigurationProperties，而 @Value 适用于简单值注入。