Spring Boot中如何手动绑定ConfigurationProperties到Bean/从配置创建Bean

核心方案：使用 Spring Boot 原生的 Binder 类 #

Spring Boot 提供了Binder工具类，完全支持@ConfigurationProperties的前缀映射、忽略未知字段等规则，能手动将指定配置源的属性绑定到Bean实例，不需要依赖容器自动创建的Bean。

具体实现步骤 #

1. 加载外部配置文件为Properties对象
   先把目标配置文件读取为Properties实例：

   Properties otherProps = new Properties();
   try (InputStream inputStream = new FileInputStream("路径/到/你的其他配置文件.properties")) {
       otherProps.load(inputStream);
   } catch (IOException e) {
       // 按需处理IO异常
   }
   

2. 通过Binder完成属性绑定
   把Properties转换成ConfigurationPropertySource后，用Binder绑定到MyBean：

   // 转换配置源格式
   ConfigurationPropertySource source = new MapConfigurationPropertySource(otherProps);
   // 创建Binder实例
   Binder binder = new Binder(source);
   
   // 执行绑定，复用@ConfigurationProperties的前缀和忽略规则
   MyBean otherBean = binder.bind("foo.bar", Bindable.of(MyBean.class)
                   .withIgnoreUnknownFields(true))
                   .orElseThrow(() -> new IllegalStateException("配置绑定失败"));
   

   如果想直接复用MyBean上@ConfigurationProperties注解的配置（不用手动写前缀和忽略字段），可以结合ConfigurationPropertiesBean：

   ConfigurationPropertiesBean propBeanMeta = ConfigurationPropertiesBean.get(MyBean.class);
   BindResult<MyBean> bindResult = new Binder(source)
           .bind(propBeanMeta.getAnnotation().prefix(),
                   Bindable.of(propBeanMeta.getType())
                           .withIgnoreUnknownFields(propBeanMeta.getAnnotation().ignoreUnknownFields()));
   MyBean otherBean = bindResult.get();
   

3. 可选：将手动创建的Bean注册到Spring容器
   如果需要让这个新Bean被Spring管理，可在配置类中通过@Bean方法注册：

   @Configuration
   public class CustomBeanConfig {
       @Bean("otherMyBean")
       public MyBean otherMyBean() throws IOException {
           Properties otherProps = new Properties();
           try (InputStream inputStream = new FileInputStream("路径/到/你的其他配置文件.properties")) {
               otherProps.load(inputStream);
           }
           ConfigurationPropertySource source = new MapConfigurationPropertySource(otherProps);
           return new Binder(source)
                   .bind("foo.bar", Bindable.of(MyBean.class).withIgnoreUnknownFields(true))
                   .orElseThrow(() -> new IllegalStateException("配置绑定失败"));
       }
   }
   

关键类说明 #

• Binder：Spring Boot核心属性绑定工具，支持多种配置源，完全兼容@ConfigurationProperties的绑定规则。
• ConfigurationPropertySource：统一配置源抽象，将Properties、Map等格式转换为Binder可处理的结构。
• ConfigurationPropertiesBean：解析@ConfigurationProperties注解的元数据，自动复用前缀、忽略未知字段等配置，减少重复代码。

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