Spring配置属性：同一列表中的多态对象解析问题

你的思路方向是对的——Spring Boot确实用SnakeYAML解析YAML配置，多态对象需要通过标签标识类型，但关键是要把自定义的SnakeYAML配置正确集成到Spring的初始化流程中，而不是单纯通过@Component注册构造器（因为Spring加载YAML解析器的时机早于Bean实例化，你的自定义构造器根本没被用上）。下面提供两种可行的解决方案：

方案一：使用YAML标签+自定义SnakeYAML构造器 #

这种方式直接利用SnakeYAML的类型标签机制，需要将自定义构造器注入到Spring的YAML解析流程中。

1. 修正YAML配置 #

可以使用全限定类名作为标签（无需额外映射），或者自定义短标签：

myapp:
  points:
    # 方式1：全限定类名标签
    - !!com.example.QuantityPoint
      name: foo
      value: 5
    # 方式2：自定义短标签（需要后续映射）
    - !state
      name: bar
      state: active

2. 集成自定义构造器到Spring Boot #

通过实现YamlPropertiesFactoryBeanCustomizer接口，在Spring创建YAML解析器时替换构造器：

import org.springframework.boot.env.YamlPropertiesFactoryBeanCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.yaml.snakeyaml.constructor.Constructor;
import org.yaml.snakeyaml.nodes.Tag;
import org.yaml.snakeyaml.TypeDescription;

@Configuration
public class YamlParsingConfig {

    @Bean
    public YamlPropertiesFactoryBeanCustomizer yamlCustomizer() {
        return factoryBean -> {
            Constructor customConstructor = new Constructor();
            // 注册自定义短标签与类的映射
            customConstructor.addTypeDescription(new TypeDescription(QuantityPoint.class, new Tag("!quantity")));
            customConstructor.addTypeDescription(new TypeDescription(StatePoint.class, new Tag("!state")));
            // 替换Spring默认的构造器
            factoryBean.setConstructor(customConstructor);
        };
    }
}

3. 确保配置类和实体类的正确性 #

• 配置类必须包含字段的getter/setter，Spring需要通过setter注入值：

@ConfigurationProperties("myapp")
@Component
public class MyConfiguration {
    private Set<Point> points;

    public Set<Point> getPoints() {
        return points;
    }

    public void setPoints(Set<Point> points) {
        this.points = points;
    }
}

• 所有子类必须提供无参构造方法（SnakeYAML默认通过无参构造实例化对象），字段建议添加getter/setter。

方案二：使用类型标识字段+自定义转换器（更友好的用户编写体验） #

如果觉得YAML标签不够直观，可以在配置中增加type字段标识类型，通过Spring的转换机制自动映射到对应子类：

1. 修改YAML配置 #

myapp:
  points:
    - name: foo
      type: quantity
      value: 5
    - name: bar
      type: state
      state: active

2. 编写自定义转换器 #

实现Spring的Converter接口，将Map<String, Object>转换为对应的Point子类：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

import java.util.Map;

@Component
public class PointConverter implements Converter<Map<String, Object>, Point> {

    @Override
    public Point convert(Map<String, Object> source) {
        String type = (String) source.get("type");
        Point point = switch (type) {
            case "quantity" -> {
                QuantityPoint qp = new QuantityPoint();
                qp.setValue((Number) source.get("value"));
                yield qp;
            }
            case "state" -> {
                StatePoint sp = new StatePoint();
                sp.setState((String) source.get("state"));
                yield sp;
            }
            default -> throw new IllegalArgumentException("Unknown point type: " + type);
        };
        point.setName((String) source.get("name"));
        return point;
    }
}

这种方式不需要修改SnakeYAML的底层配置，完全利用Spring的转换体系，对编写YAML的用户更友好。

验证方案 #

可以通过注入MyConfiguration并打印结果验证：

@SpringBootApplication
public class DemoApp implements CommandLineRunner {

    @Autowired
    private MyConfiguration config;

    public static void main(String[] args) {
        SpringApplication.run(DemoApp.class, args);
    }

    @Override
    public void run(String... args) {
        config.getPoints().forEach(point -> {
            System.out.println("类型：" + point.getClass().getSimpleName());
            System.out.println("名称：" + point.getName());
            if (point instanceof QuantityPoint qp) {
                System.out.println("数值：" + qp.getValue());
            } else if (point instanceof StatePoint sp) {
                System.out.println("状态：" + sp.getState());
            }
        });
    }
}

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