Spring同名不同包MyService Bean定义冲突问题求助

先看你遇到的核心异常信息：

Failed to instantiate [org.springframework.context.annotation.AnnotationConfigApplicationContext]: Constructor threw exception; nested exception is org.springframework.context.annotation.ConflictingBeanDefinitionException: Annotation-specified bean name 'myService' for bean class [my.package.ejb.MyService] conflicts with existing, non-compatible bean definition of same name and class [my.package.other.ejb.MyService]

为什么会出现这个冲突？ #

• 你的两个MyService是EJB 2.0无状态Bean，虽然没加任何Spring注解，但SpringBeanAutowiringInterceptor会自动把这些EJB纳入Spring容器管理。默认情况下，Spring会用类名首字母小写作为bean名称（也就是myService），两个同名类自然会产生名称冲突。
• 你配置的@ComponentScan("my.package")会扫描指定包下的Spring组件，但真正触发冲突的不是它直接扫描到了EJB，而是SpringBeanAutowiringInterceptor已经把EJB注册成了Spring bean，而@ComponentScan的范围覆盖了这些EJB包，导致重复注册逻辑触发了命名冲突。
• 至于@MapperScan，它只负责扫描MyBatis的Mapper接口并生成代理bean，根本不会碰你的EJB类，所以跟它完全没关系。

解决办法 #

这里给你几个可行的方案，按需选择：

1. 给EJB指定唯一的Bean名称 #

虽然是EJB 2.0，你可以给每个MyService加上Spring的@Service（或@Component）注解，手动指定不同的bean名称：

// my.package.ejb.MyService
@Service("coreMyService")
public class MyService implements ... {
    // 类逻辑不变
}

// my.package.other.ejb.MyService
@Service("otherMyService")
public class MyService implements ... {
    // 类逻辑不变
}

这样Spring容器里的两个bean名称就不会重复了，冲突自然解决。

2. 缩小@ComponentScan的扫描范围，排除EJB包 #

如果不想给EJB加Spring注解，可以修改@ComponentScan的配置，排除EJB所在的子包，避免Spring组件扫描和EJB注册逻辑重叠：

@Configuration
@ComponentScan(
    basePackages = "my.package",
    excludeFilters = {
        @ComponentScan.Filter(
            type = FilterType.REGEX,
            pattern = "my\\.package\\..*\\.ejb.*"
        )
    }
)
@MapperScan("my.package")
public class ApplicationConfiguration {
    // 现有DataSource、SqlSessionFactory等Bean配置不变
}

这样Spring只会扫描你需要的业务组件，不会碰EJB类，也就不会产生冲突。

3. 自定义Bean命名策略 #

如果上面两种方法都不适合，你可以实现Spring的BeanNameGenerator接口，自定义一个命名规则，比如把包名+类名作为bean名称的一部分，确保同名类的bean名称唯一。然后在SpringBeanAutowiringInterceptor或者Spring上下文配置中指定这个自定义的命名策略。

举个简单的自定义命名器示例：

public class PackageAwareBeanNameGenerator extends DefaultBeanNameGenerator {
    @Override
    public String generateBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) {
        String className = definition.getBeanClassName();
        if (className != null) {
            // 把包名替换成连字符分隔的前缀
            String packagePrefix = className.substring(0, className.lastIndexOf("."))
                .replace(".", "-");
            return packagePrefix + "-" + super.generateBeanName(definition, registry);
        }
        return super.generateBeanName(definition, registry);
    }
}

然后在配置中指定这个生成器（比如通过@ComponentScan的nameGenerator属性，或者在EJB拦截器的配置中指定）。

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