Spring Boot如何用@Value直接获取单个配置Client对象？

现有如下YAML配置：

application:
  api:
    clients:
      api1:
        url: http://url1
      api2:
        url: http://url2
        basicAuth:
          username: user2
          password: password2

可通过以下代码使用@ConfigurationProperties正常绑定配置：

@Configuration
@ConfigurationProperties(prefix = "application.api")
@Data
public class ApiProperties {

    private Map<String, Client> clients;

    @Data
    public static class Client {
        private String url;
        private BasicAuth basicAuth;
    }

    @Data
    public static class BasicAuth {
        private String username;
        private String password;
    }

}

但想要只获取其中一个client，尝试替换private Map<String, Client> clients;为如下写法时：

@Value("${application.api.clients['api1']}")
private Client client1;

始终出现Could not resolve placeholder...错误，求解决方案。

@Value本身不支持直接绑定嵌套复杂对象，它仅能处理简单类型（如String、int）或通过SpEL获取单一属性。要绑定单个嵌套的Client对象，推荐使用以下两种方案：

方案1：为单个Client单独配置@ConfigurationProperties #

直接为目标client创建专属配置类，指定精确的前缀路径：

@Configuration
@ConfigurationProperties(prefix = "application.api.clients.api1")
@Data
public class Api1ClientProperties {
    private String url;
    private BasicAuth basicAuth;

    @Data
    public static class BasicAuth {
        private String username;
        private String password;
    }
}

Spring会自动将application.api.clients.api1下的所有属性绑定到该类实例中，直接注入即可使用。

方案2：在原有配置类中扩展获取单个client的方法 #

若不想新增配置类，可在原ApiProperties中添加获取指定client的方法，保留Map绑定的同时提供快捷获取方式：

@Configuration
@ConfigurationProperties(prefix = "application.api")
@Data
public class ApiProperties {

    private Map<String, Client> clients;

    // 直接提供api1的获取方法
    public Client getApi1Client() {
        return clients.get("api1");
    }

    @Data
    public static class Client {
        private String url;
        private BasicAuth basicAuth;
    }

    @Data
    public static class BasicAuth {
        private String username;
        private String password;
    }
}

后续在需要使用的地方注入ApiProperties，调用getApi1Client()即可拿到目标对象。

补充：强制使用@Value的方式（不推荐） #

若一定要用@Value，只能逐个绑定对象的属性，无法直接绑定整个Client对象，示例：

@Value("${application.api.clients.api1.url}")
private String api1Url;

// 可选属性可添加默认值避免配置缺失报错
@Value("${application.api.clients.api1.basicAuth.username:#{null}}")
private String api1Username;

这种方式仅适合属性极少的场景，属性较多时会非常繁琐，远不如@ConfigurationProperties简洁。

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