同名Spring Configuration类未全部注册问题求助

问题根源 #

JVM中，同一类加载器下全限定类名（包名+类名）相同的类只能被加载一次。你的两个MyConfiguration类虽然来自不同Gradle依赖，但包名和类名完全一致，类加载器加载时会自动忽略其中一个，这和@Configuration指定的Bean名称无关——Spring根本没机会加载被忽略的那个类。

可行解决方案 #

方案1：给不同版本的类分配不同包名（最推荐）

无需修改类名，只需调整Mustache模板，把majorVersion融入包名中，比如生成com.example.v{{majorVersion}}.MyConfiguration。这样每个版本的类全限定名唯一，Spring自动扫描时会正常识别并注册所有配置类。

相比修改类名，调整包名的模板改动量极小，只需在包声明处加入版本变量：

package com.example.v{{majorVersion}};

@Configuration("MyConfiguration{{majorVersion}}")
public class MyConfiguration {
    // 其余代码
}

方案2：编程式手动注册Bean定义（适合无法修改包/类名的场景）

绕过Spring自动扫描，通过自定义ImportBeanDefinitionRegistrar，用不同类加载器加载不同版本的配置类，再手动注册为Spring Bean：

@Configuration
public class MultiVersionConfigRegistrar implements ImportBeanDefinitionRegistrar {
    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        // 注册v1版本配置类
        registerConfigClass(registry, "v1", "path/to/your/v1-dependency.jar");
        // 注册v2版本配置类
        registerConfigClass(registry, "v2", "path/to/your/v2-dependency.jar");
    }

    private void registerConfigClass(BeanDefinitionRegistry registry, String version, String jarPath) {
        try {
            // 创建独立类加载器加载对应版本的JAR
            URL jarUrl = new File(jarPath).toURI().toURL();
            ClassLoader versionClassLoader = new URLClassLoader(new URL[]{jarUrl}, getClass().getClassLoader());
            
            // 加载配置类
            Class<?> configClass = Class.forName("com.example.MyConfiguration", true, versionClassLoader);
            
            // 注册为Spring Bean，指定唯一名称
            BeanDefinition beanDef = BeanDefinitionBuilder.genericBeanDefinition(configClass).getBeanDefinition();
            registry.registerBeanDefinition("MyConfiguration" + version, beanDef);
        } catch (Exception e) {
            throw new RuntimeException("Failed to register config class for version: " + version, e);
        }
    }
}

然后在主配置类上添加@Import(MultiVersionConfigRegistrar.class)，即可完成两个版本配置类的注册。

方案3：类加载器隔离（复杂度较高）

通过Gradle的类加载器隔离插件，将不同版本的依赖分配到独立的类加载器中。这种方式无需修改代码，但配置复杂度高，适合多版本依赖深度隔离的场景。

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