Spring Boot中@ConfigurationProperties无法填充未知名称嵌套属性问题

核心错误：配置映射路径不匹配 #

你的UpProperties类中，@ConfigurationProperties(prefix = "api")已经指定了前缀为api，但类内又定义了private Map<String, ApiProperty> api;字段，这会导致Spring尝试从api.api.foo这样的路径加载配置，而你的YAML配置是直接在api.foo层级，两者不匹配，因此Map无法被填充。

修正步骤 #

1. 调整类结构，移除多余层级 #

修改UpProperties类，将Map字段名改为与前缀不冲突的名称（比如services），让它直接映射api前缀下的所有子节点（foo、bar、baz）：

@ConfigurationProperties(prefix = "api")
public class UpProperties {

    // 直接映射api下的foo/bar/baz等服务节点
    private Map<String, ApiProperty> services;

    // 必须添加getter和setter，Spring依赖这些方法注入属性
    public Map<String, ApiProperty> getServices() {
        return services;
    }

    public void setServices(Map<String, ApiProperty> services) {
        this.services = services;
    }

    public static class ApiProperty {
        private HealthCheck upCheck;

        // 添加getter和setter
        public HealthCheck getUpCheck() {
            return upCheck;
        }

        public void setUpCheck(HealthCheck upCheck) {
            this.upCheck = upCheck;
        }
    }

    public static class HealthCheck {
        private boolean enabled;
        private String version;
        private String url;

        // 添加getter和setter
        public boolean isEnabled() {
            return enabled;
        }

        public void setEnabled(boolean enabled) {
            this.enabled = enabled;
        }

        public String getVersion() {
            return version;
        }

        public void setVersion(String version) {
            this.version = version;
        }

        public String getUrl() {
            return url;
        }

        public void setUrl(String url) {
            this.url = url;
        }
    }
}

2. 启用配置属性绑定 #

确保Spring能够识别并加载UpProperties类，有两种方式：

• 方式一：给UpProperties添加@Component注解
  在类上加上@Component，让Spring自动扫描并注册这个配置类：

  @Component
  @ConfigurationProperties(prefix = "api")
  public class UpProperties {
      // ...类内容同上
  }
  

• 方式二：在配置类中启用@EnableConfigurationProperties
  创建或修改现有配置类，显式启用配置属性绑定：

  @Configuration
  @EnableConfigurationProperties(UpProperties.class)
  public class AppConfig {
  }
  

3. 验证配置占位符（可选） #

确保YAML中的${foo.baseUrl}、${foo.version}等占位符已经在其他配置（如application.properties、环境变量或配置中心）中正确定义，否则可能导致属性值加载异常，但这不会影响Map本身的填充。

完成以上步骤后，services Map就会自动填充foo、bar、baz等服务的配置信息，新增服务时只需在YAML中添加对应节点即可，无需修改代码。

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