Spring Boot从YAML文件读取数组失败，求解决方案

看起来你遇到的情况挺典型的——明明配置文件能正常加载（毕竟单个字符串配置能读取），但注入集合类型时却提示找不到占位符。我来帮你拆解问题并给出可行的解决方案：

先提一个小细节（非核心但值得注意） #

你代码里的这个注入：

@Value("${document.hello.test}")
String hello;

但你的application.yml里对应的配置是：

hello:
  test: "hello"

正确的配置键应该是${hello.test}，而不是${document.hello.test}。你说这个能正常访问，要么是配置里还有其他地方定义了document.hello.test，要么是笔误——不过这不是当前集合注入问题的核心，先记下来。

解决方案1：使用@ConfigurationProperties绑定配置（推荐） #

对于集合、嵌套结构这类复杂配置，Spring的@ConfigurationProperties比@Value更可靠，也更贴合Spring Boot的最佳实践。

步骤1：创建配置类 #

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import java.util.List;

@Configuration
@ConfigurationProperties(prefix = "document.templates")
public class DocumentTemplateConfig {
    private List<String> filetypes;

    // 必须提供getter和setter，Spring需要通过它们完成配置绑定
    public List<String> getFiletypes() {
        return filetypes;
    }

    public void setFiletypes(List<String> filetypes) {
        this.filetypes = filetypes;
    }
}

步骤2：在Endpoint中注入配置类 #

@Autowired
private DocumentTemplateConfig documentTemplateConfig;

// 在任意方法中使用集合配置
public void someMethod() {
    List<String> fileTypes = documentTemplateConfig.getFiletypes();
    System.out.println(fileTypes);
}

这种方式不仅能完美解决集合注入问题，还能让配置结构更清晰，后续维护也更方便。

解决方案2：调整@Value的写法（适用于简单场景） #

如果你坚持要用@Value，可以尝试通过SpEL表达式直接解析YAML数组：

@Value("#{${document.templates.filetypes}}")
List<String> templatesFileTypes;

如果担心配置不存在导致报错，还可以加上默认空列表：

@Value("#{${document.templates.filetypes:[]}}")
List<String> templatesFileTypes;

为什么@Value直接注入会失败？ #

虽然Spring理论上支持@Value注入YAML数组，但实际使用中可能因为以下原因出问题：

1. 部分Spring版本对YAML数组的@Value解析支持不够完善；
2. 配置文件存在隐性格式问题（比如缩进不一致、特殊字符干扰）；
3. 项目中存在自定义的PropertyResolver，干扰了默认的配置解析逻辑。

而@ConfigurationProperties是Spring专门为配置绑定设计的功能，会更严格地解析YAML结构，避免这类问题。

最后再确认配置格式 #

你的application.yml中数组的缩进是正确的，保持这个格式即可：

document:
  templates:
    filetypes:
      - elem1
      - elem2
      - elem3
      - elem4
hello:
  test: "hello"

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