Spring配置属性无法将YAML中Map绑定到Object问题排查

核心问题1：配置前缀与字段名重复，导致路径匹配失败 #

你给CountryProperties标注的@ConfigurationProperties(prefix="project.country-properties")已经指定了配置的根路径，但类里的字段名叫countryProperties——这会让Spring去寻找project.country-properties.country-properties这个不存在的配置节点，根本匹配不到france的配置数据，最终导致整个CountryProperties实例为null。

核心问题2：未启用配置属性类（必做步骤） #

如果不明确告诉Spring要加载这个配置属性类，容器不会主动创建它的实例，同样会出现对象为null的情况。

修复步骤 #

1. 修改配置类的字段名 #

把CountryProperties里的countryProperties字段改为直接对应project.country-properties下的国家节点，比如countries：

@Getter
@AllArgsConstructor
@ConstructorBinding
@ConfigurationProperties(prefix="project.country-properties") 
public class CountryProperties {
      private Map<String, CountryData> countries;

      @Getter
      @Setter
      public static class CountryData {
          private String capital; 
          private Integer population; 
      }   
}

2. 启用配置属性类 #

在Spring Boot主启动类或任意配置类上添加以下注解之一：

• 方式一：直接指定要启用的配置类

@SpringBootApplication
@EnableConfigurationProperties(CountryProperties.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

• 方式二：扫描配置属性类所在的包（如果类在主启动类的子包下，此注解可省略；否则需指定包路径，如@ConfigurationPropertiesScan("com.yourpackage.properties")）

@SpringBootApplication
@ConfigurationPropertiesScan
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 可选：统一构造绑定（非必须，但更规范） #

由于你使用了@ConstructorBinding，可以给CountryData也添加构造绑定注解，去掉@Setter，让所有属性通过构造方法注入，符合不可变对象设计：

@Getter
@AllArgsConstructor
@ConstructorBinding
public static class CountryData {
    private String capital; 
    private Integer population; 
}

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