Spring如何解析YAML动态键名并映射为自定义类列表

你最开始的写法不生效，核心原因是Spring默认将section.subsections下的动态键值对识别为Map<String, Object>结构，不会自动把Map的key注入到值对象的字段中，没有对标Micronaut@Parameter的开箱注解，不需要找对应注解，最稳妥的实现方式如下：

方案1：Map接收后手动转换（推荐，无额外依赖） #

这是兼容性最好、逻辑最可控的实现，不需要修改现有YAML结构，也不需要引入额外依赖：

1. 先保留你的CustomClass定义，不需要加Spring配置注解，作为普通POJO即可：

import lombok.Getter;
import lombok.RequiredArgsConstructor;

// 不用final字段的话可以去掉@RequiredArgsConstructor，写无参构造+setter即可
@Getter
@RequiredArgsConstructor
public class CustomClass {
    private final String subsectionName;
    private final String param1;
    private final String param2;
}

2. 定义外层配置绑定类，先把section.subsections下的内容绑定为Map<String, 子属性>结构，在构造/赋值阶段直接把Map转换为你需要的List<CustomClass>：

import lombok.Getter;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.ConstructorBinding;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;

// SpringBoot 2.2+支持构造函数绑定，低版本去掉@ConstructorBinding，用setter赋值即可
@ConfigurationProperties(prefix = "section")
@ConstructorBinding
@Getter
public class SectionProperties {
    private final List<CustomClass> customClassList;

    public SectionProperties(Map<String, SubSectionProps> subsections) {
        List<CustomClass> list = new ArrayList<>(subsections.size());
        // 遍历Map，把key作为subsectionName传入，和value里的属性组装成CustomClass
        subsections.forEach((subsectionKey, subVal) ->
                list.add(new CustomClass(subsectionKey, subVal.getParam1(), subVal.getParam2()))
        );
        this.customClassList = list;
    }

    // 内部类用来接收每个subsection下的param1、param2字段
    @Getter
    @RequiredArgsConstructor
    public static class SubSectionProps {
        private final String param1;
        private final String param2;
    }
}

3. 如果需要直接在容器中注入List<CustomClass>，可以额外注册一个Bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.List;

@Configuration
public class CustomBeanConfig {
    @Bean
    public List<CustomClass> customClassList(SectionProperties properties) {
        return properties.getCustomClassList();
    }
}

完成后你既可以通过注入SectionProperties拿到转换好的List，也可以直接注入List<CustomClass>传给需要List入参的公共工具类。

注意事项 #

• 如果你用的是SpringBoot 2.2以下版本，不支持构造函数绑定，去掉@ConstructorBinding，给类加上无参构造、给subsections字段加setter，在setter方法里做Map转List的逻辑即可。
• 不建议为了这个需求自定义配置绑定后置处理器等复杂扩展，维护成本高，Spring版本升级时容易出现兼容问题。
• 不推荐通过修改YAML为固定List结构实现，会破坏现有配置用业务名作为key的可读性，也不符合你当前的配置现状。

内容的提问来源于stack exchange，提问作者nikiforov.java