如何基于第三方AutoConfigured Bean动态创建N组关联命名Bean？

核心思路 #

利用Spring的ImportBeanDefinitionRegistrar在容器初始化阶段动态注册Bean，通过Bean名称引用确保依赖顺序，解决第三方CustomHttpClient未初始化的问题，同时批量生成包装Http Bean和业务Client Bean。

步骤1：定义配置绑定类 #

先把YAML中的客户端配置数组绑定到Java类，方便后续读取：

@ConfigurationProperties(prefix = "app.clients")
public class ClientProperties {
    private List<String> names = new ArrayList<>();

    // Getter & Setter
}

对应的YAML配置示例：

app:
  clients:
    names:
      - simon
      - griffin

步骤2：定义包装类与业务Client类 #

先实现CustomHttpClient的包装Bean，以及依赖它的业务Client Bean：

// 包装CustomHttpClient的Bean
public class WrappedHttpClient {
    private final CustomHttpClient customHttpClient;
    private final String clientName;

    public WrappedHttpClient(CustomHttpClient customHttpClient, String clientName) {
        this.customHttpClient = customHttpClient;
        this.clientName = clientName;
        // 这里添加你的包装逻辑，比如拦截、参数定制等
    }

    // 暴露业务所需的HttpClient方法
}

// 应用实际使用的业务Client Bean
public class AppClient {
    private final WrappedHttpClient wrappedHttpClient;

    public AppClient(WrappedHttpClient wrappedHttpClient) {
        this.wrappedHttpClient = wrappedHttpClient;
    }

    // 实现业务逻辑方法
}

步骤3：实现动态Bean注册器 #

通过ImportBeanDefinitionRegistrar批量注册两种Bean，同时确保依赖第三方的CustomHttpClient：

public class DynamicClientRegistrar implements ImportBeanDefinitionRegistrar, EnvironmentAware {
    private Environment environment;

    @Override
    public void setEnvironment(Environment environment) {
        this.environment = environment;
    }

    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        // 从环境中读取配置
        ClientProperties properties = Binder.get(environment)
                .bind("app.clients", ClientProperties.class)
                .orElse(new ClientProperties());

        for (String name : properties.getNames()) {
            // 1. 注册包装Http Bean（如simonBeanHttp）
            String httpBeanName = name + "BeanHttp";
            BeanDefinition httpBeanDef = BeanDefinitionBuilder.genericBeanDefinition(WrappedHttpClient.class)
                    .addConstructorArgReference("customHttpClient") // 直接引用第三方自动配置的Bean名称
                    .addConstructorArgValue(name)
                    .getBeanDefinition();
            registry.registerBeanDefinition(httpBeanName, httpBeanDef);

            // 2. 注册业务Client Bean（如simonBeanClient），依赖对应的包装Http Bean
            String clientBeanName = name + "BeanClient";
            BeanDefinition clientBeanDef = BeanDefinitionBuilder.genericBeanDefinition(AppClient.class)
                    .addConstructorArgReference(httpBeanName)
                    .getBeanDefinition();
            registry.registerBeanDefinition(clientBeanName, clientBeanDef);
        }
    }
}

步骤4：启用动态注册 #

在主配置类中导入注册器，并启用配置属性绑定：

@Configuration
@EnableConfigurationProperties(ClientProperties.class)
@Import(DynamicClientRegistrar.class)
// 如果知道第三方CustomHttpClient的自动配置类，添加以下注解确保执行顺序
// @AutoConfigureAfter(CustomHttpClientAutoConfiguration.class)
public class DynamicClientConfiguration {
}

关键注意点 #

• 依赖顺序保证：通过@AutoConfigureAfter指定在第三方自动配置类之后执行，或者依赖Spring自动的Bean定义顺序（因为我们直接引用customHttpClient的Bean名称，Spring会自动处理实例化顺序）。
• 避免直接获取Bean实例：在注册Bean定义阶段，容器还未完成实例化，必须通过Bean名称引用的方式建立依赖，不能尝试获取实例对象。
• 动态Bean名称生成：循环中直接根据配置的客户端名称拼接Bean名称，无需额外传入参数，满足批量生成需求。

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