Spring Boot项目通用处理DuplicateBeanException异常的方案咨询

方案1：自定义全局Bean名称生成策略（最推荐） #

Spring默认使用短类名作为Bean名称，不同包下的同名类会触发重名冲突。你可以自定义Bean名称生成规则，用类的全限定名作为Bean名称，从根源避免重名。

实现步骤 #

1. 自定义名称生成器

import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.BeanNameGenerator;

public class FullClassNameBeanNameGenerator implements BeanNameGenerator {
    @Override
    public String generateBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) {
        return definition.getBeanClassName();
    }
}

2. 启动类绑定生成器

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication(nameGenerator = FullClassNameBeanNameGenerator.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

该方案全局生效，覆盖包括第三方库在内的所有自动扫描的Bean，无额外侵入性，基本不会产生新的冲突。

方案2：自定义Bean注册后置处理器（兼容手动指定Bean名称的场景） #

如果第三方库手动指定了@Bean的name属性导致重名，你可以通过BeanDefinitionRegistryPostProcessor在Bean注册阶段自动识别重名Bean并修改名称。

实现代码 #

import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.BeanDefinitionRegistryPostProcessor;
import org.springframework.stereotype.Component;
import java.util.HashMap;
import java.util.Map;

@Component
public class DuplicateBeanResolveProcessor implements BeanDefinitionRegistryPostProcessor {
    private final Map<String, Integer> beanNameCounter = new HashMap<>();

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        String[] allBeanNames = registry.getBeanDefinitionNames();
        for (String originalName : allBeanNames) {
            BeanDefinition definition = registry.getBeanDefinition(originalName);
            String className = definition.getBeanClassName();
            if (className == null) continue;
            // 重名检测
            int count = beanNameCounter.getOrDefault(originalName, 0);
            if (count > 0) {
                // 生成唯一新名称
                String newBeanName = className + "#" + count;
                registry.removeBeanDefinition(originalName);
                registry.registerBeanDefinition(newBeanName, definition);
            }
            beanNameCounter.put(originalName, count + 1);
        }
    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
    }
}

方案3：开启Bean覆盖（不推荐生产使用） #

如果仅需要快速调试，可以在application.yml中开启Bean覆盖开关，后注册的Bean会自动覆盖同名称的已注册Bean：

spring:
  main:
    allow-bean-definition-overriding: true

该方案风险较高，你无法控制覆盖优先级，可能出现非预期的Bean实例。

注意事项 #

• 所有自动处理方案生效后，业务代码尽量按类型注入Bean，如果需要按名称注入请使用全类名匹配。
• 若第三方库存在同全类名的冲突（概率极低），可在名称生成规则中追加Jar包名称标识做区分。

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