SpringBoot加载yaml配置到HashMap报错：无法解析grpc.channels占位符

问题根因 #

@Value注解仅支持注入单个简单值、简单类型集合/Map，无法直接完成复杂嵌套配置节点到自定义POJO类型的Map绑定，你的写法把grpc.channels当成了单个配置Key查找，自然会报找不到占位符的错误。SpringBoot中绑定结构化的嵌套配置，需要使用@ConfigurationProperties注解实现。

解决步骤 #

1. 修改配置类代码 #

给配置类添加@ConfigurationProperties注解指定配置前缀，补充所有字段的Getter/Setter方法（Spring配置绑定依赖Setter完成）：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.Map;

@Component
@ConfigurationProperties(prefix = "grpc")
public class ChannelProperties {

    private Map<String, ChannelConfiguration> channels;

    // 必加：channels字段的getter、setter
    public Map<String, ChannelConfiguration> getChannels() {
        return channels;
    }
    public void setChannels(Map<String, ChannelConfiguration> channels) {
        this.channels = channels;
    }

    public static class ChannelConfiguration {
        private String hostname;
        private String port;

        // 必加：内部类字段的getter、setter
        public String getHostname() {
            return hostname;
        }
        public void setHostname(String hostname) {
            this.hostname = hostname;
        }
        public String getPort() {
            return port;
        }
        public void setPort(String port) {
            this.port = port;
        }
    }
}

2. 开启配置属性绑定支持 #

你可以选择两种方式开启绑定：

• 方式一：给ChannelProperties类加上@Component注解，确保该类能被Spring的组件扫描到（如上代码已经添加）
• 方式二：在启动类上添加@EnableConfigurationProperties(ChannelProperties.class)注解，无需给配置类加@Component：

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

3. 校验配置文件 #

确保你的yaml配置放在src/main/resources/application.yml（或对应profile的配置文件）中，缩进、拼写完全正确，没有被其他配置覆盖。

完成以上步骤后，你就可以在需要的地方直接注入ChannelProperties类，调用getChannels()方法获取配置好的Map数据。

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