@value是spring中轻量级配置注入方式,用于注入单个简单值,支持默认值(如${app.name:unknown})和spel表达式(如#{...}),但仅适用于spring管理bean,不支持构造函数注入,复杂配置推荐@configurationproperties。

在 Java Spring 项目中,@Value 注解是最轻量、最直接的配置属性注入方式,适用于注入单个简单值(如字符串、数字、布尔值等)。
基本用法:注入 application.properties/yml 中的属性
确保类被 Spring 管理(如加了 @Component、@Service 或其他 stereotype 注解),然后在字段或 setter 方法上使用 @Value:
- 配置文件中写:
app.timeout=3000 - 代码中注入:
@Value("${app.timeout}")<br>private int timeout;
Spring 启动时会自动从环境(Environment)中查找 app.timeout 的值,并尝试转换为 int 类型。若未找到,启动会报错(除非提供默认值)。
提供默认值避免启动失败
用冒号 : 指定默认值,当配置不存在或为空时生效:
-
@Value("${app.name:unknown}") private String name;→ 若app.name未配置,name值为"unknown" -
@Value("${app.retry.count:3}") private int retryCount;→ 支持类型自动转换,默认为3 - 注意:默认值不能含空格(除非用单引号包裹,如
'my app')
支持 SpEL 表达式做简单计算或逻辑判断
@Value 底层基于 Spring EL,可执行简单表达式:
@Value("#{systemProperties['os.name'].toLowerCase().contains('win') ? 'C:/tmp' : '/tmp'}") private String tmpDir;@Value("#{${app.enabled:true} and ${feature.flag:false}}") private boolean canExecute;- 注意:SpEL 表达式用
#{...},而占位符用${...};两者可嵌套使用
常见问题与注意事项
使用 @Value 时需留意以下几点:
- 只能用于 Spring 管理的 Bean(非 new 出来的对象无效)
- 不支持构造函数注入(字段或 setter 方式即可,推荐字段+
final+@PostConstruct配合校验) - 若属性是集合或复杂对象,建议改用
@ConfigurationProperties,更安全、可校验、支持松散绑定 - 敏感配置(如密码)不建议明文写在配置文件中,应结合 Spring Cloud Config、Vault 或环境变量注入
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











