Spring Boot父类嵌套@ConfigurationProperties未加载问题排查

核心问题1：配置绑定结构设计错误 #

你当前的写法将Task类以独立@Bean的形式注册到Spring容器，它和ApplicationProperties是两个完全独立的Bean，并不会作为ApplicationProperties的属性被自动绑定，所以你从ApplicationProperties实例中获取Task相关属性自然为空。

核心问题2：配置值拼写错误 #

你配置中task.job[1].errors=${nas1Root}/Errors/CIF_Dist存在占位符拼写错误，缺少app.前缀，正确写法为task.job[1].errors=${app.nas1Root}/Errors/CIF_Dist，否则启动时会出现占位符解析异常。

推荐解决方案（方案一：合并为单一配置类，符合常规设计） #

调整ApplicationProperties结构，去掉Task的@Bean定义，将Task作为普通属性，添加对应的配置绑定注解即可，修改后代码如下：

package com.nationwide.ess.contentcollector.config;

import java.util.List;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.NestedConfigurationProperty;

import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@ConfigurationProperties(prefix="app")
public class ApplicationProperties {
  private String activeEnv;
  private String nas1Root;
  private String nas2Root;

  // 新增Task属性，添加嵌套配置注解，单独指定前缀
  @NestedConfigurationProperty
  @ConfigurationProperties(prefix = "task")
  private Task task;
  
  @Data
  @NoArgsConstructor
  public static class Task {
    private String triggerCron;
    private List<Job> job;

    @Data
    @NoArgsConstructor
    public static class Job {
      private String name;
      private List<String> monitor;
      private String processed;
      private String errors;
      private List<String> triggerTimes;
    }
  }
}

该方案修改后，你可以直接通过注入ApplicationProperties，调用getTask()方法获取所有task相关的配置值。

备选解决方案（方案二：独立使用Task配置Bean） #

如果你希望保留Task作为独立Bean的设计，不需要将它放到ApplicationProperties中，按以下步骤修改：

1. 去掉ApplicationProperties类中定义的task() Bean方法
2. 给Task类添加@ConfigurationProperties(prefix = "task")注解：

@Data
@NoArgsConstructor
@ConfigurationProperties(prefix = "task")
public static class Task {
  // 原有属性保持不变
}

3. 在启动类的@EnableConfigurationProperties注解中添加Task类：

@EnableConfigurationProperties({ApplicationProperties.class, ApplicationProperties.Task.class})

该方案修改后，你需要单独注入ApplicationProperties.Task类型的Bean来获取task相关配置。

验证方式 #

可以在任意Spring管理的Bean中添加测试逻辑验证绑定结果，示例如下：

@Autowired
private ApplicationProperties applicationProperties;

@PostConstruct
public void testConfig() {
  log.info("activeEnv: {}", applicationProperties.getActiveEnv());
  log.info("task triggerCron: {}", applicationProperties.getTask().getTriggerCron());
  log.info("job size: {}", applicationProperties.getTask().getJob().size());
}

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