是否有类似@JsonTypeInfo/@JsonSubTypes的@ConfigurationProperties子类映射机制？

核心需求 #

根据配置中的auth-type字段，将WebClient配置分别映射到BasicAuthWebClientConfig和OAuth2WebClientConfig子类，替代包含所有字段的“多用途”父类，避免对象建模上的争议。

Spring Boot的@ConfigurationProperties本身没有类似Jackson@JsonTypeInfo的自动子类型绑定机制，但可以通过自定义Converter实现这一需求，以下是具体步骤：

1. 定义父类与子类结构 #

先抽取出公共字段作为抽象父类，再为每种认证类型创建专属子类：

@Data
public abstract class WebClientConfig {
    private String baseUrl;
    private String authType;
}

@Data
public class BasicAuthWebClientConfig extends WebClientConfig {
    private String username;
    private String password;
}

@Data
public class OAuth2WebClientConfig extends WebClientConfig {
    private String clientRegistration;
}

2. 调整主配置类 #

保持原有的Map<String, WebClientConfig>结构，用于存储多个WebClient配置：

@Data
@ConfigurationProperties(prefix = "application")
public class WebClientConfigurations {
    private Map<String, WebClientConfig> webclients;
}

3. 自定义类型转换Converter #

创建实现Converter接口的类，并添加@ConfigurationPropertiesBinding注解，让Spring在绑定配置时使用该转换器将配置Map转换为对应子类实例：

@Component
@ConfigurationPropertiesBinding
public class WebClientConfigConverter implements Converter<Map<String, Object>, WebClientConfig> {

    @Override
    public WebClientConfig convert(Map<String, Object> source) {
        String authType = (String) source.get("auth-type");
        
        switch (authType) {
            case "basic-auth":
                BasicAuthWebClientConfig basicConfig = new BasicAuthWebClientConfig();
                basicConfig.setBaseUrl((String) source.get("base-url"));
                basicConfig.setAuthType(authType);
                basicConfig.setUsername((String) source.get("username"));
                basicConfig.setPassword((String) source.get("password"));
                return basicConfig;
            case "oauth2":
                OAuth2WebClientConfig oauthConfig = new OAuth2WebClientConfig();
                oauthConfig.setBaseUrl((String) source.get("base-url"));
                oauthConfig.setAuthType(authType);
                oauthConfig.setClientRegistration((String) source.get("client-registration"));
                return oauthConfig;
            default:
                throw new IllegalArgumentException("不支持的认证类型: " + authType);
        }
    }
}

4. 配置校验（可选） #

为子类添加校验逻辑，确保对应认证类型的必填字段存在，避免歧义：

@Data
public class BasicAuthWebClientConfig extends WebClientConfig {
    private String username;
    private String password;

    @AssertTrue(message = "basic-auth类型必须配置username和password")
    public boolean isBasicAuthFieldsValid() {
        return "basic-auth".equals(getAuthType()) && username != null && password != null;
    }
}

替代方案说明 #

如果不需要Map形式的多配置，也可以为每种认证类型单独定义@ConfigurationProperties类，结合@ConditionalOnProperty注解根据auth-type条件化加载，但这种方式不适用于你当前的多WebClient配置场景，因此自定义Converter是更合适的选择。

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