Spring Boot版本升级风云再起，Gateway与OpenFeign的纠葛始末

2022-11-12 04:56:31

版本升级风云再起：Spring Cloud Gateway 与 OpenFeign 的纠葛始末

一、问题的源头：OpenFeignClient 的幽灵

随着 Spring Boot、Spring Cloud 和 Spring Cloud Alibaba 迎来版本升级的浪潮，许多开发者却在升级时遭遇了棘手的难题——Spring Cloud Gateway 在启动时无故卡住。究其根源，便是 OpenFeignClient 在 Gateway 中的隐秘阻碍。

OpenFeignClient 是一个 HTTP 客户端，旨在简化跨微服务调用。然而，在 Gateway 中，OpenFeignClient 的代理对象却无法正常工作，因为它无法访问 OpenFeignClient 的私有方法和属性。这就像一个幽灵般的存在，悄然扰乱了 Gateway 的正常运行。

二、问题排查：循序渐进，步步为营

1. 卸载 OpenFeignClient：

首先，我们尝试在 Gateway 中禁用 OpenFeignClient。如果 Gateway 能够正常启动，那么问题确实出在 OpenFeignClient 身上。

// application.yml
spring.cloud.gateway.httpclient.enabled: false

2. 升级 Spring Cloud Gateway：

如果禁用 OpenFeignClient 无法解决问题，那么可以尝试升级 Spring Cloud Gateway 的版本。Spring Cloud Gateway 2.2.1 版本已经修复了此问题。

三、问题的解决：双管齐下，妙手回春

1. 注解注入：

在 OpenFeignClient 中使用 @FeignClient 注解来注入代理对象：

// FooService.java
@FeignClient(name = "foo-service")
public interface FooService {
    // ...
}

2. Qualifier 注解：

在 Gateway 中使用 @Qualifier 注解来指定代理对象：

// MyGatewayAutoConfiguration.java
@Bean
@Qualifier("fooService")
public FooService fooService() {
    return Feign.builder().target(FooService.class, "http://foo-service");
}

四、总结：庖丁解牛，拨云见日

Spring Cloud Gateway 卡住的问题看似棘手，但只要我们了解其根源，并采取适当措施，便能迎刃而解。本文详细剖析了问题产生的原因，并提供了两种行之有效的解决方法。希望这篇文章能够帮助各位开发者顺利解决升级难题，让 Gateway 在云端乘风破浪。

常见问题解答

1. 为什么 OpenFeignClient 在 Gateway 中无法正常工作？

因为 OpenFeignClient 的代理对象无法访问其私有方法和属性。

2. 如何在 Gateway 中禁用 OpenFeignClient？

在 application.yml 中设置 spring.cloud.gateway.httpclient.enabled: false。

3. 如何升级 Spring Cloud Gateway 版本？

在 pom.xml 中升级 spring-cloud-gateway 的版本。

4. 为什么使用 @FeignClient 注解注入代理对象？

@FeignClient 注解可以生成一个更准确的代理对象，解决无法访问私有方法和属性的问题。

5. 为什么使用 @Qualifier 注解指定代理对象？