本文详解如何使用 ByteBuddy 在运行时生成带 @Configuration 注解的 Spring Boot 配置类，并通过 ApplicationContextInitializer 显式注册，使其被 Spring 容器识别并生效。
本文详解如何使用 bytebuddy 在运行时生成带 `@configuration` 注解的 spring boot 配置类，并通过 `applicationcontextinitializer` 显式注册，使其被 spring 容器识别并生效。
在 Spring Boot 中，配置类（@Configuration）的加载依赖于类路径扫描（classpath scanning）——即 Spring 启动时通过 ClassPathBeanDefinitionScanner 扫描 @ComponentScan 范围内的 .class 文件。而 ByteBuddy 生成的类默认仅存在于内存中，不落盘为 .class 文件，也不会被自动加入类路径，因此即使成功添加了 @Configuration 注解，Spring 也完全无法发现该类，更不会执行其中的 @Bean 方法（如示例中的 hello()）。
要使动态生成的配置类生效，核心思路是：绕过类路径扫描，改用编程方式显式注册 Bean 定义。推荐方案是结合 ApplicationContextInitializer 与 BeanDefinitionRegistry，在 Spring 上下文刷新前完成注册。
以下是可直接运行的完整实现：
import net.bytebuddy.ByteBuddy;
import net.bytebuddy.dynamic.loading.ClassLoadingStrategy;
import net.bytebuddy.implementation.FixedValue;
import net.bytebuddy.implementation.MethodDelegation;
import net.bytebuddy.jar.asm.Opcodes;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContextInitializer;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.type.StandardAnnotationMetadata;
import java.lang.invoke.MethodHandles;
@SpringBootApplication
public class TestApp {
public static void main(String[] args) {
SpringApplication app = new SpringApplication(TestApp.class);
// 关键：注册初始化器，在上下文准备阶段注入动态配置
app.addInitializers(new DynamicConfigInitializer());
app.run(args);
}
// 自定义 ApplicationContextInitializer
static class DynamicConfigInitializer implements ApplicationContextInitializer<configurableapplicationcontext> {
@Override
public void initialize(ConfigurableApplicationContext applicationContext) {
if (applicationContext.getBeanFactory() instanceof BeanDefinitionRegistry registry) {
try {
// 使用 ByteBuddy 生成配置类
Class> generatedConfig = new ByteBuddy()
.subclass(Object.class)
.name("com.example.GeneratedConfig")
.annotateType(Configuration.class) // 添加 @Configuration
.defineMethod("hello", Object.class, Opcodes.ACC_PUBLIC | Opcodes.ACC_STATIC)
.annotateMethod(Bean.class) // 添加 @Bean
.intercept(FixedValue.value(new Object())) // 简化实现：直接返回新 Object
.make()
.load(TestApp.class.getClassLoader(), ClassLoadingStrategy.UsingLookup.of(
MethodHandles.privateLookupIn(Object.class, MethodHandles.lookup())
))
.getLoaded();
// 手动注册为 Configuration 类的 BeanDefinition
BeanDefinitionBuilder builder = BeanDefinitionBuilder.genericBeanDefinition(generatedConfig);
builder.setRole(BeanDefinition.ROLE_INFRASTRUCTURE); // 标记为基础设施类
registry.registerBeanDefinition("generatedConfig", builder.getBeanDefinition());
} catch (Exception e) {
throw new RuntimeException("Failed to generate and register dynamic config", e);
}
}
}
}
}</configurableapplicationcontext>
✅ 关键要点说明：
- ✅ 不依赖类路径扫描：通过 BeanDefinitionRegistry.registerBeanDefinition() 直接注入，确保 Spring 在 refresh() 阶段处理该配置类；
- ✅ 正确设置注解元数据：@Configuration 和 @Bean 必须通过 ByteBuddy 显式添加（.annotateType() / .annotateMethod()），且需使用 StandardAnnotationMetadata 兼容 Spring 的元数据解析；
- ✅ 避免静态方法陷阱：示例中 hello() 声明为 static 是为了简化拦截逻辑（FixedValue），但真实场景建议生成实例方法 + MethodDelegation 实现复杂逻辑；
- ⚠️ 注意类加载器一致性：务必使用与 Spring 上下文相同的类加载器（如 TestApp.class.getClassLoader()），否则可能引发 ClassNotFoundException 或代理失效；
- ⚠️ 生产慎用：动态生成配置类适用于高度定制化场景（如多数据源、插件化模块），但会增加调试难度和类加载复杂度，建议优先考虑 @ConfigurationProperties + @ConditionalOnProperty 等声明式方案。
最终效果：应用启动后，GeneratedConfig 类被识别为配置类，其 @Bean 方法将被调用，对应 Bean 成功注入容器——真正实现“运行时按需生成 Spring 配置”。
