使用ByteBuddy生成Spring Boot配置遇到的问题

核心原因 #

动态生成的@Configuration类未被Spring Boot上下文识别，主要涉及类加载时机、Spring组件扫描范围、ByteBuddy加载策略三个方面的问题：

1. Spring组件扫描未覆盖动态类 #

Spring Boot默认扫描@SpringBootApplication所在包及其子包的组件，但即使动态类的包名符合要求，Spring的扫描逻辑在启动初期就已执行，动态生成的类可能未被纳入扫描范围。

2. ByteBuddy加载策略导致类未被Spring感知 #

你使用的ClassLoadingStrategy.UsingLookup加载策略，可能未将动态类注册到Spring能访问的类加载器命名空间中，或者加载后的类未被Spring的Bean定义机制捕获。

3. 动态类未主动注册到Spring上下文 #

即使类加载成功，若未显式告知Spring该类是配置类，Spring不会自动发现并处理其中的@Bean方法。

具体解决步骤 #

步骤1：调整ByteBuddy类加载策略 #

改用ClassLoadingStrategy.Default.INJECTION策略，确保动态类被注入到应用类加载器中，让Spring能够访问：

private static Class<?> generateConf() throws Exception {
    return new ByteBuddy()
        .subclass(GeneratedConfigBase.class)
        .name("com.example.GeneratedConfig")
        .annotateType(AnnotationDescription.Builder.ofType(Configuration.class).build())
        .make()
        .load(TestApp.class.getClassLoader(), ClassLoadingStrategy.Default.INJECTION)
        .getLoaded();
}

步骤2：主动将动态类注册到Spring上下文 #

在Spring启动时，通过SpringApplicationBuilder.sources()方法显式注册生成的配置类，确保Spring将其纳入上下文管理：

public static void main(String[] args) throws Exception {
    Class<?> generatedConfig = generateConf();
    new SpringApplicationBuilder(TestApp.class)
        .sources(generatedConfig)
        .run(args);
}

步骤3：验证注解正确性 #

确保AnnotationDescription.Builder正确构建了@Configuration注解，检查是否导入了正确的包：

import org.springframework.context.annotation.Configuration;

额外排查点 #

• 检查动态类的包名是否在Spring扫描范围内（若TestApp在com.example包下，com.example.GeneratedConfig符合要求）。
• 若动态类需要生成多个数据源Bean，确保@Bean方法的逻辑正确，且方法可见性为public。
• 可以通过添加日志或调试断点，确认动态类是否成功加载，以及Spring是否尝试初始化该类。

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