Micronaut中@EachProperty使用环境变量值为何无法正常工作？

当@EachProperty使用硬编码路径"some.other.config"时，配置类中的所有属性（name、somMapConf、someListConf）均能正常加载；但改用带环境变量占位符的路径"some.{env.var}.config"后，仅name属性能被正确注入，somMapConf和someListConf始终为null。

配置类代码 #

@EachProperty(value = "some.{env.var}.config")
@Data
public class SomeConfiguration {

    private final String name;

    @MapFormat
    private Map<String, String> somMapConf;

    private List<String> someListConf;

    public SomeConfiguration(@Parameter String name) {
        this.name = name;
    }
}

配置文件内容（YAML） #

some:
  other:
    config:
      name1:
        somMapConf:
          key1: value1
          key2: value2
        someListConf:
          - element1
          - element2
          - element2
      name2:
        somMapConf:
          key1: value1
          key2: value2
        someListConf:
          - element1
          - element2
          - element2

解决方案 #

核心原因 #

动态占位符的解析时机导致配置加载器无法正确拼接子属性的完整路径，进而无法定位到somMapConf和someListConf的配置节点。

具体修复步骤 #

1. 验证环境变量有效性
   确认env.var环境变量已正确注入应用，且值为other（与配置文件中的节点匹配），避免占位符解析后路径不匹配。

2. 显式标记子属性路径
   为子属性添加@Property注解，明确指定相对于当前配置节点的属性名，强制加载器正确识别子属性路径：

   @EachProperty(value = "some.{env.var}.config")
   @Data
   public class SomeConfiguration {
   
       private final String name;
   
       @MapFormat
       @Property(name = "somMapConf")
       private Map<String, String> somMapConf;
   
       @Property(name = "someListConf")
       private List<String> someListConf;
   
       public SomeConfiguration(@Parameter String name) {
           this.name = name;
       }
   }
   

3. 开启配置调试日志
   添加日志配置查看路径解析细节，排查是否存在路径拼写或解析错误：

   logger:
       levels:
           io.micronaut.context.env: DEBUG
           io.micronaut.configuration.properties: DEBUG
   

   从日志中可以看到占位符解析后的完整路径，以及子属性的加载过程，快速定位问题点。

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