Spring Boot 3如何从外部YAML导入配置到列表属性？

在Spring Boot 3应用中，想要在application.yml里定义一个属性列表，要求列表的每个元素从其他YAML文件导入。尝试第一种方式时触发错误，但第二种逐个引用属性的方式可以正常运行，询问如何让第一种方式生效。

第一种尝试（报错） #

provider1.yml 内容 #

provider1:
  name: MyProvider
  priority: 2

application.yml 内容 #

spring:
  config:
    import:
      - classpath:providers/provider1.yml
      - classpath:providers/provider2.yml

providers:
  list:
    - ${provider1}
    - ${provider2}

ProviderProperties.java 内容 #

@Configuration
@ConfigurationProperties(prefix = "providers")
@EnableConfigurationProperties
@Data
public class ProviderProperties {
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    @Builder
    public static class ProviderConfig {
        private Map<Integer, List<String>> discriminator;
        private String token;
        private String byField;
        private List<String> serviceIds;
        private int priority;
        private String name;
        private int prefixLength;
    }
    private List<ProviderConfig> list;
}

运行错误 #

Failed to bind properties under 'providers.list[0]' to my.package.ProviderProperties$ProviderConfig:

    Reason: org.springframework.core.convert.ConverterNotFoundException: No converter found capable of converting from type [java.lang.String] to type [my.package.ProviderProperties$ProviderConfig]

第二种可行方式 #

application.yml 内容 #

spring:
  config:
    import:
      - classpath:providers/provider1.yml
      - classpath:providers/provider2.yml

providers:
  list:
    - name: ${provider1.name}
      priority: ${provider1.priority}
    - name: ${provider2.name}
      priority: ${provider2.priority}

第一种方式报错的核心原因是：${provider1}这类占位符会被Spring解析成字符串形式的属性路径，而非直接映射为ProviderConfig对象，因此Spring找不到能完成字符串到自定义对象转换的转换器。

以下两种方法可以实现直接导入整个配置对象到列表的需求：

方法1：修改子配置文件前缀，直接对应列表元素 #

把子配置文件的配置前缀改为providers.list[索引]，Spring导入后会自动将配置绑定到对应列表位置，无需在application.yml中手动定义列表结构。

修改后的 provider1.yml #

providers:
  list:
    - name: MyProvider
      priority: 2

修改后的 provider2.yml #

providers:
  list:
    - name: AnotherProvider
      priority: 1

application.yml 仅保留配置导入 #

spring:
  config:
    import:
      - classpath:providers/provider1.yml
      - classpath:providers/provider2.yml

这种方式下，Spring会自动合并所有导入文件中providers.list的配置，最终生成完整的属性列表，是Spring Boot配置绑定的常规用法，推荐优先使用。

方法2：自定义转换器实现字符串到对象的转换 #

如果不想修改子配置文件的前缀，可以自定义转换器，让Spring能够将属性路径字符串转换为ProviderConfig对象：

1. 创建转换器类：

@Component
public class StringToProviderConfigConverter implements Converter<String, ProviderProperties.ProviderConfig> {
    private final Environment environment;
    private final ConfigurationPropertiesBinder binder;

    public StringToProviderConfigConverter(Environment environment, ConfigurationPropertiesBinder binder) {
        this.environment = environment;
        this.binder = binder;
    }

    @Override
    public ProviderProperties.ProviderConfig convert(String source) {
        ProviderProperties.ProviderConfig config = new ProviderProperties.ProviderConfig();
        binder.bind(ConfigurationPropertyName.of(source), Bindable.ofInstance(config));
        return config;
    }
}

2. 确保该转换器被Spring组件扫描机制捕获，之后即可继续使用第一种方式的application.yml配置。

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