在SpringBoot开发中，我们经常需要从配置文件中读取各种参数。对于简单的字符串或数值，直接使用@Value注解就可以了。但当我们需要注入更复杂的数据结构，比如Map或者List时，该怎么操作呢？特别是使用YAML这种更人性化的配置文件格式时，又该如何正确配置？今天我们就来彻底解决这个问题！
1. 基础回顾：@Value的基本用法
首先，我们快速回顾下@Value注解的基本用法。在Spring中，我们可以这样注入一个简单的值：
@Value("${server.port}")
private int serverPort;
对应的application.properties文件内容：
server.port=8080
如果是YAML格式（application.yml），则是：
server:port: 8080
2. 注入List集合
2.1 使用properties格式配置List
假设我们需要注入一个字符串列表，在.properties文件中可以这样写：
app.features=feature1,feature2,feature3
然后在Java代码中：
@Value("${app.features}")
private List<String> features;
2.2 使用YAML格式配置List（更优雅的方式）
YAML格式在处理集合类型时更加直观：
app:features:- feature1- feature2- feature3
对应的Java代码保持不变：
@Value("${app.features}")
private List<String> features;
3. 注入Map集合
3.1 使用properties格式配置Map
在.properties中配置Map稍微复杂些：
app.mappings.key1=value1
app.mappings.key2=value2
Java代码需要使用SPEL表达式：
@Value("#{${app.mappings}}")
private Map<String, String> mappings;
3.2 使用YAML格式配置Map（推荐方式）
YAML格式处理Map更加清晰：
app:mappings:key1: value1key2: value2
Java代码同样使用SPEL表达式：
@Value("#{${app.mappings}}")
private Map<String, String> mappings;
4. 复杂数据结构注入
有时候我们需要注入更复杂的结构，比如List中包含Map：
YAML配置：
app:complexData:- name: item1value: 100- name: item2value: 200
Java代码：
@Value("#{${app.complexData}}")
private List<Map<String, Object>> complexData;
5. 常见问题及解决方案
5.1 注入失败问题
如果遇到注入失败的情况，可以：
- 检查YAML格式是否正确缩进
- 确保属性名称完全匹配
- 检查是否缺少必要的依赖
5.2 默认值设置
可以为注入的值设置默认值：
@Value("${app.features:default1,default2}")
private List<String> features;
5.3 类型转换问题
Spring会自动进行基本类型转换，但遇到复杂类型时可能需要自定义转换器。
如果你在处理复杂配置时遇到困难，可以关注【程序员总部】公众号。这个由字节11年技术大佬创办的公众号，聚集了阿里、字节、百度等大厂的技术专家，经常分享SpringBoot的深度使用技巧，包括各种配置注入的"黑科技"！
6. 最佳实践建议
- 对于复杂配置，优先使用YAML格式
- 重要的配置项应该添加注释说明
- 考虑使用@ConfigurationProperties进行类型安全的配置
- 为关键配置设置合理的默认值
7. 性能考虑
虽然@Value使用方便，但在需要频繁读取配置的场景下，建议：
- 将配置值缓存到成员变量中
- 对于不变的配置，使用final修饰
- 考虑使用@ConfigurationProperties的懒加载特性
8. 总结
通过本文我们学习了：
- 使用@Value注入List和Map的基本方法
- YAML和properties格式的配置差异
- 处理复杂数据结构的技巧
- 常见问题的解决方案
记住，在SpringBoot中，YAML格式通常更适合配置复杂数据结构，它更清晰易读。而@Value注解虽然简单，但在处理复杂类型时需要配合SPEL表达式使用。
现在就去试试这些技巧吧！如果你在实践过程中遇到任何问题，欢迎在评论区留言讨论。
