Azure Function集成Spring Boot使用FullyQualifiedAnnotationBeanNameGenerator遇Bean冲突

错误含义 #

这个ConflictingBeanDefinitionException表示Spring容器中出现了两个同名的Bean定义，名称都是serviceImpl，分别对应com.company.pkg.service.ServiceImpl和com.company.otherpkg.service.ServiceImpl，容器无法区分这两个Bean，导致初始化失败。

产生原因 #

你虽然在@SpringBootApplication的@ComponentScan中指定了FullyQualifiedAnnotationBeanNameGenerator，但Spring Cloud Function的Azure适配器在初始化函数实例时，并未继承这个配置：

• AzureFunctionInstanceInjector在创建函数实例的过程中，会触发一套独立的Bean扫描/初始化逻辑，这套逻辑使用了Spring默认的AnnotationBeanNameGenerator（生成类名首字母小写的短名称），而非你配置的全限定名生成器。
• 即便你调试时看到部分Bean用了全限定名，但适配器的额外扫描逻辑会重新注册这两个ServiceImpl类，并用短名称作为Bean名，最终引发冲突。

另外，你的两个ServiceImpl类都标注了@Component且未显式指定Bean名称，默认情况下Spring会用类名首字母小写作为Bean名，一旦有未使用你配置的名称生成器的扫描逻辑，就会触发这个冲突。

解决方案 #

1. 显式指定Bean名称（最直接有效） #

给每个@Component注解显式设置唯一的Bean名称，彻底避免名称冲突：

// com.company.pkg.service.ServiceImpl
@Component("pkgServiceImpl")
@Qualifier("myUniqueQualifier")
public class ServiceImpl implements Service<TypeIn, TypeOut> {
    // ...业务代码
}

// com.company.otherpkg.service.ServiceImpl
@Component("otherpkgServiceImpl")
@Qualifier("anotherQualifier")
public class ServiceImpl implements Service<TypeIn, TypeOut> {
    // ...业务代码
}

2. 确保名称生成器全局生效 #

创建单独的配置类，全局配置Spring的Bean名称生成器，覆盖默认逻辑：

@Configuration
public class BeanNameConfig {
    @Bean
    public BeanNameGenerator beanNameGenerator() {
        return new FullyQualifiedAnnotationBeanNameGenerator();
    }
}

同时确保该配置类被@SpringBootApplication的扫描范围覆盖，让所有组件扫描逻辑都使用全限定名作为Bean名。

3. 手动注册Bean（更可控） #

放弃@Component注解，在配置类中手动注册这两个实现类，指定唯一的Bean名称：

@Configuration
public class ServiceConfig {
    @Bean("pkgServiceImpl")
    @Qualifier("myUniqueQualifier")
    public Service<TypeIn, TypeOut> pkgServiceImpl() {
        return new com.company.pkg.service.ServiceImpl();
    }

    @Bean("otherpkgServiceImpl")
    @Qualifier("anotherQualifier")
    public Service<TypeIn, TypeOut> otherpkgServiceImpl() {
        return new com.company.otherpkg.service.ServiceImpl();
    }
}

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