Spring配置类中@Bean可见Map<String,POJO>，构造函数不可见的原因及优化

你的配置类代码如下：

@Data //setters and getters
@ComponentScan
@Configuration
@ConfigurationProperties(prefix = "some.prefix")
public class SomeAutoConfig {

    public SomeAutoConfig(Map<String, Pojo> properties) {
        this.properties= properties;
    }

    private final Map<String, Pojo> properties;

    @Bean
    String string() {
        return "test string";
    }

}

为什么构造函数中properties不可见，@Bean方法中却可见？ #

• Spring处理@ConfigurationProperties的逻辑是先实例化Bean，再通过属性绑定器(Binder)把配置值绑定到Bean的属性上，这个绑定动作发生在构造函数执行之后。
• 你构造函数中的Map<String, Pojo> properties参数，Spring会尝试从IoC容器中查找同类型的Bean进行注入，但此时容器里并没有这个类型的Bean，所以该参数是无效的（通常为null）。而类中private final Map<String, Pojo> properties属性，是在Bean实例化完成后被@ConfigurationProperties绑定赋值的，@Bean方法执行时Bean已经完成属性绑定，因此能看到有效值。

让属性在构造函数中可访问的两种方案 #

方案1：使用@ConstructorBinding（Spring Boot 2.2+推荐） #

在配置类上添加@ConstructorBinding注解，Spring会在构造Bean的阶段就完成配置属性的绑定，此时构造函数参数就能拿到正确的配置值：

@Data
@Configuration
@ConfigurationProperties(prefix = "some.prefix")
@ConstructorBinding // 核心注解，开启构造函数绑定
public class SomeAutoConfig {

    private final Map<String, Pojo> properties;

    public SomeAutoConfig(Map<String, Pojo> properties) {
        this.properties = properties;
        // 这里可以正常访问properties
    }

    @Bean
    String string() {
        return "test string";
    }
}

注意：使用@ConstructorBinding时，无需额外添加@ComponentScan（@Configuration已足够让Spring识别该类），且配置类必须是顶级类（不能是内部类）。

方案2：改用字段绑定+@PostConstruct初始化 #

如果不需要在构造阶段直接处理属性，可以去掉构造函数，让@ConfigurationProperties自动绑定到字段，再通过@PostConstruct在属性绑定完成后执行初始化逻辑：

@Data
@Configuration
@ConfigurationProperties(prefix = "some.prefix")
public class SomeAutoConfig {

    private Map<String, Pojo> properties;

    @PostConstruct
    void init() {
        // 这里能访问到绑定后的properties，可在此做初始化操作
    }

    @Bean
    String string() {
        return "test string";
    }
}

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