Feign报错‘xx.FeignClientSpecification‘, defined in null, could not be registered.

错误描述：

版本使用的是SpringBoot: 2.1.0.RELEASE，SpringCloud: Greenwich.M1，OpenFeign: 2.1.0.M2
报错：

The bean 'xxxx.FeignClientSpecification', defined in null, could not be registered. 
A bean with that name has already been defined in null and overriding is disabled.

Caused by: org.springframework.beans.factory.support.BeanDefinitionOverrideException: 
Invalid bean definition with name xxxx.FeignClientSpecification' defined in null: 
Cannot register bean definition [Generic bean: class [org.springframework.cloud.openfeign.FeignClientSpecification]; 
scope=; abstract=false; lazyInit=false; autowireMode=0; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=null;
factoryMethodName=null; initMethodName=null; destroyMethodName=null] for bean 'xxxx.FeignClientSpecification': 
There is already [Generic bean: class [org.springframework.cloud.openfeign.FeignClientSpecification]; scope=; abstract=false; lazyInit=false; 
autowireMode=0; dependencyCheck=0; autowireCandidate=true; primary=false;
factoryBeanName=null; factoryMethodName=null; initMethodName=null; destroyMethodName=null] bound.

分析：

多个接口上的@FeignClient(“相同服务名”)会报错，overriding is disabled，即出现了相同的Bean名。

在启动类中添加的@EnableFeignClients中，可看到@import引入FeignClientsRegistrar实现注入。

核心是BeanDefinitionRegistry

注册FeignClients

    public void registerFeignClients(AnnotationMetadata metadata,
			BeanDefinitionRegistry registry) {
		ClassPathScanningCandidateComponentProvider scanner = getScanner();
		scanner.setResourceLoader(this.resourceLoader);

		Set<String> basePackages;

		Map<String, Object> attrs = metadata
				.getAnnotationAttributes(EnableFeignClients.class.getName());
		AnnotationTypeFilter annotationTypeFilter = new AnnotationTypeFilter(
				FeignClient.class);
		final Class<?>[] clients = attrs == null ? null
				: (Class<?>[]) attrs.get("clients");
		if (clients == null || clients.length == 0) {
			scanner.addIncludeFilter(annotationTypeFilter);
			basePackages = getBasePackages(metadata);
		}
		else {
			final Set<String> clientClasses = new HashSet<>();
			basePackages = new HashSet<>();
			for (Class<?> clazz : clients) {
				basePackages.add(ClassUtils.getPackageName(clazz));
				clientClasses.add(clazz.getCanonicalName());
			}
			AbstractClassTestingTypeFilter filter = new AbstractClassTestingTypeFilter() {
				@Override
				protected boolean match(ClassMetadata metadata) {
					String cleaned = metadata.getClassName().replaceAll("\\$", ".");
					return clientClasses.contains(cleaned);
				}
			};
			scanner.addIncludeFilter(
					new AllTypeFilter(Arrays.asList(filter, annotationTypeFilter)));
		}

		for (String basePackage : basePackages) {
			Set<BeanDefinition> candidateComponents = scanner
					.findCandidateComponents(basePackage);
			for (BeanDefinition candidateComponent : candidateComponents) {
				if (candidateComponent instanceof AnnotatedBeanDefinition) {
					// verify annotated class is an interface
					AnnotatedBeanDefinition beanDefinition = (AnnotatedBeanDefinition) candidateComponent;
					AnnotationMetadata annotationMetadata = beanDefinition.getMetadata();
					Assert.isTrue(annotationMetadata.isInterface(),
							"@FeignClient can only be specified on an interface");

					Map<String, Object> attributes = annotationMetadata
							.getAnnotationAttributes(
									FeignClient.class.getCanonicalName());

					String name = getClientName(attributes);
					registerClientConfiguration(registry, name,
							attributes.get("configuration"));

					registerFeignClient(registry, annotationMetadata, attributes);
				}
			}
		}
	}

其中registerFeignClient方法需要装配BeanDefinitionBuilder对象，可以看到这里实际注入的是FeignClientFactoryBean。
BeanDefinitionHolder中传递了beanName，而它是等于annotationMetadata.getClassName();，即被FeignClient注解的接口的全限定类名。
那么它的Bean名不会重复，错误原因并不是它引起的。

而注册configuration实际注入的是FeignClientSpecification，这就是我们所报错的already存在的Bean。
可看到 beanName：name + "." + FeignClientSpecification.class.getSimpleName()

而其中的name参数，就是在registerFeignClients方法中通过getClientName()获得。

String name = getClientName(attributes);
registerClientConfiguration(registry, name, attributes.get("configuration"));

在getClientName()源码中，可以看到name就是@FeignClient注解中的serviceId，name，value。
beanName：name + "." + FeignClientSpecification.class.getSimpleName()
故而我们在使用相同名称的FeigClient注解时，注入到Ioc的是相同Bean名。
所以错误是由FeignClientSpecification类引起的。

解决：

在application.yml中配置：

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

在SpringBoot 2.1之前，这个配置默认就是true，而在2.1做了更改。
设置为true后，因为FeignClientSpecification的原因，FeignClient注解的configuration参数会被覆盖。

解决配置覆盖参考：
https://blog.csdn.net/neosmith/article/details/82349449

个人觉得Stackoverflow中有位大佬说的不错：
https://stackoverflow.com/questions/53103991/cant-stat-app-after-updating-springboot-from-2-0-6-release-to-2-1-0-release

别的情况下也可能会因为Bean名重复引起该错误，更佳的解决方案是尽可能避免去定义相同的Bean名。
而Feign远程调用服务因为业务需求出现在不同在接口上使用相同的服务名，将allow-bean-definition-overriding设置为true，如果在其他情况下没有重复Bean名，那么受影响的应该就只是Feign的configuration（然而configuration我都没另外做配置，覆盖也不影响- -）。

---

评论里大佬推荐在注解中添加 contextId 来区分，解决该问题。

@FeignClient(name="common-service", contextId = "example")