Spring Boot为何@Value无法注入yml配置的List/Map类型值

问题现象 #

• 使用application.properties定义配置时，通过@Value可以正常注入List、Map类型：
  properties配置示例

  list=1,2,3
  map={"1":"1","2":"2","3":"3"}
  

  注入代码示例

  @Value("${list}")
  private List<String> list;
  @Value("#{${map}}")
  private Map<String, String> map;
  
  // 运行输出
  // [1, 2, 3]
  // {1=1, 2=2, 3=3}
  

• 将配置转换为application.yml的原生结构化写法后，相同的@Value写法会直接注入失败，仅能通过@ConfigurationProperties标注的配置类完成注入：
  yml配置示例

  my:
    list: [ "1","2","3" ]
    map:
      "1": "1"
      "2": "2"
      "3": "3"
  

  注入效果对比

  // 注入失败，拿到null值
  @Value("${my.list}")
  private List<String> list;
  @Value("#{${my.map}}")
  private Map<String, String> map;
  
  // 注入成功
  @Data
  @Component
  @ConfigurationProperties(prefix = "my")
  public class MyConfiguration {
      private List<String> list;
      private Map<String, String> map;
  }
  @Autowired
  private MyConfiguration myConfiguration;
  

根本原因 #

两种配置文件的解析逻辑存在本质差异：

1. Properties是纯键值对格式，所有配置值都会被解析为字符串。你写list=1,2,3时，list对应的属性值就是字符串1,2,3，@Value内置的类型转换器会自动按逗号分割为List；你写map={"1":"1","2":"2"}时，map对应的是JSON格式字符串，配合SpEL表达式#{${map}}就能直接解析为Map对象。
2. YAML是结构化配置格式，当你使用YAML原生数组、对象语法定义List、Map时，Spring不会把整个集合映射为单个字符串属性，而是会将结构打平为带索引、带键名的独立属性：

   list[0]=1
   list[1]=2
   list[2]=3
   map.1=1
   map.2=2
   map.3=3
   

   此时Spring Environment中根本不存在名为list、map的单值属性，@Value("${list}")自然找不到对应配置，拿到null后注入失败。这种结构下你只能通过@Value("${list[0]}")、@Value("${map.1}")这类指定具体索引/键的写法获取单个元素，无法直接拿到整个集合对象。

可选解决方案 #

• 方案1（不推荐）：在YAML中把List、Map写成和properties一致的字符串格式，就能用@Value正常注入：

  list: 1,2,3
  map: '{"1":"1","2":"2","3":"3"}'
  

  这种写法完全放弃了YAML的结构化优势，可读性差，容易写错格式。
• 方案2（官方推荐）：对于List、Map、嵌套对象这类复杂类型配置，统一使用@ConfigurationProperties做类型安全绑定，不依赖字符串解析逻辑，不管配置是properties还是yml格式都能稳定工作，还支持参数校验、IDE配置提示等能力。

内容的提问来源于stack exchange，提问作者lone