错误描述
在 Spring Cloud 项目中通过 Open Feign 远程调用时出现如下错误:
feign.codec.EncodeException: No qualifying bean of type 'org.springframework.boot.autoconfigure.http.HttpMessageConverters' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}
...
Spring Cloud 版本:Hoxton.SR9
Spring Cloud Alibaba 版本:2.2.2.RELEASE
Spring Boot 版本:2.3.7.RELEASE
错误原因
从报错信息中不难看出,错误原因是容器中缺少 HttpMessageConverters
这样一个 bean 对象。
GitHub 上 spring-cloud/spring-cloud-openfeign 与此相关的 issue:https://github.com/spring-cloud/spring-cloud-openfeign/issues/235。
在 spring-boot-autoconfigure 的较新版本中(具体哪个版本我也不知道),HttpMessageConverters
的自动配置条件更改了,可以参见 HttpMessageConvertersAutoConfiguration
类:
// 这里省去了其他无关注解
@ConditionalOnClass({HttpMessageConverter.class})
@Conditional({HttpMessageConvertersAutoConfiguration.NotReactiveWebApplicationCondition.class})
public class HttpMessageConvertersAutoConfiguration {}
因为现在的 Spring Cloud Gateway 是基于 WebFlux 的,是 Reactive Web。所以根据 @Conditional
的条件,HttpMessageConvertersAutoConfiguration
就不会生效,进而也不会进行自动配置,就导致容器中缺少 HttpMessageConverters
对象。
解决方案
这个问题解决方法也很简单,只需自己写一个配置类,向容器中注册一个 HttpMessageConverters
对象即可。方法可以从 HttpMessageConvertersAutoConfiguration
中复制。参考如下:
@Configuration
public class FeignConfig {@Bean@ConditionalOnMissingBeanpublic HttpMessageConverters messageConverters(ObjectProvider<HttpMessageConverter<?>> converters) {return new HttpMessageConverters(converters.orderedStream().collect(Collectors.toList()));}
}
重启项目,问题解决。