知识点扫盲——SpringCloud feign是什么？

---

---

0 前言

今天在概要设计评审过程中，领导问了一个问题，为什么要使用feign调用，而不是直接走http接口调用？我草草回答了 使用http接口调用走公网，涉及接口签名和验签，会引入额外的工作量，糊弄了过去，会后开始补课，学习一下什么是feign。

1 引言

微服务架构中，服务间通信是构建可扩展、灵活系统的核心。

随着服务数量的增加，传统的单体应用中的直接方法调用不再适用，取而代之的是远程过程调用（RPC）。Feign，作为Spring Cloud生态中的一个声明式Web服务客户端，提供了一种简洁的方式来实现服务间的HTTP调用，简化了远程服务调用的复杂性，还使得服务间的通信更加直观和易于管理。

2 Feign简介

Feign是Spring Cloud中一个声明式的Web服务客户端，它使得编写Web服务客户端变得更加简单。Feign的声明式特性意味着开发者只需要通过创建一个接口并使用注解的方式来定义服务调用，Feign会自动生成代理实现类。这种方式与Spring的RestTemplate相比，减少了模板代码的编写，使得代码更加简洁和易于维护。

Feign与其他服务调用方式，如Java原生的HttpClient，有着明显的区别。

• HttpClient需要手动编写请求和响应的处理逻辑，而Feign则通过注解和模板方法自动完成这些工作。
• Feign整合了Spring MVC的注解，使得开发者可以使用@RequestMapping等注解来定义服务接口，Feign接口的编写与Spring MVC控制器非常相似，学习成本低。
• Feign支持可插拔的编码器和解码器，开发者可以自定义数据的序列化和反序列化方式，以适应不同的数据传输需求。

3 Feign的核心特性

3-1.声明式REST客户端

Feign作为声明式REST客户端，极大地简化了HTTP客户端代码的编写。开发者只需定义一个接口，并使用注解来指定服务的URL和HTTP操作类型，Feign会自动生成实现类。例如，使用@FeignClient注解指定服务名，@GetMapping、@PostMapping等注解声明具体的HTTP请求。这种声明方式不仅减少了模板代码，还使得服务调用的代码更加清晰和易于理解。

3-2.编码器和解码器

Feign通过编码器（Encoder）和解码器（Decoder）处理请求和响应的序列化与反序列化。Feign默认使用Spring的HttpMessageConverters，支持JSON、XML等多种格式的数据交换。开发者可以根据需要自定义编码器和解码器，以支持特定的序列化库，如Gson、Jackson等，或者处理特殊的数据格式。这种灵活性使得Feign能够适应不同的数据传输需求。

3-3.错误处理

Feign提供了强大的错误处理机制。当服务调用失败时，Feign允许开发者定义错误处理策略，例如重试逻辑、熔断机制等。通过集成Hystrix等容错工具，Feign可以在服务调用失败时提供备选方案，从而提高系统的可用性和稳定性。此外，Feign还支持自定义异常处理，开发者可以定义全局的错误处理逻辑，或者为特定的服务调用配置错误处理策略。

4 Feign的配置和使用

Feign的配置和使用是理解其如何简化微服务间通信的关键。以下是如何在Spring Cloud应用中配置Feign客户端以及如何使用Feign进行服务调用的步骤。

4-1. 配置Feign

在Spring Cloud应用中配置Feign客户端非常简单。首先，确保你的项目中已经包含了Spring Cloud的依赖，并且启用了Feign客户端。这通常通过在启动类上添加@EnableFeignClients注解来实现。

@SpringBootApplication
@EnableFeignClients
public class YourApplication {public static void main(String[] args) {SpringApplication.run(YourApplication.class, args);}
}

接下来，定义一个Feign客户端接口，并使用@FeignClient注解来指定目标服务。例如，如果你有一个名为user-service的服务，你可以这样配置Feign客户端：

@FeignClient(name = "user-service")
public interface UserServiceClient {@GetMapping("/users/{id}")User getUserById(@PathVariable("id") Long id);
}

在这个例子中，@FeignClient(name = "user-service")指定了要调用的服务名，而@GetMapping("/users/{id}")定义了一个GET请求，用于获取指定ID的用户信息。

4-2. 使用Feign进行服务调用

一旦Feign客户端接口被定义，使用它就像调用本地方法一样简单。Spring容器会自动为你的接口生成一个代理实现，你可以直接注入这个接口并使用它。

@RestController
public class UserController {@Autowiredprivate UserServiceClient userServiceClient;@GetMapping("/user/{id}")public User getUser(@PathVariable("id") Long id) {return userServiceClient.getUserById(id);}
}

在上面的代码中，我们注入了UserServiceClient，并在一个REST控制器中使用它来获取用户信息。当/user/{id}路径被访问时，Feign客户端会自动向user-service服务发起GET请求，获取并返回用户数据。

Feign还支持多种配置项，如连接超时、重试策略等，可以通过application.yml或application.properties文件进行配置：

feign:client:config:default:connectTimeout: 5000readTimeout: 5000loggerLevel: full

这段配置设置了Feign客户端的默认连接超时和读取超时时间，并开启了详细日志记录，这对于调试和监控服务调用非常有用。

5 Feign的高级特性

Feign不仅提供了基本的服务调用功能，还集成了一些高级特性，以增强微服务架构的健壮性和可维护性。

5-1. 服务降级

服务降级是一种提高系统可用性的策略，当某个服务不可用时，系统会临时提供备选方案，以避免系统完全失败。Feign可以通过与Hystrix集成来实现服务降级。Hystrix是一个延迟和容错库，可以帮助系统在依赖服务不可用时保持响应。

@FeignClient(name = "user-service", fallback = UserClientFallback.class)
public interface UserServiceClient {@GetMapping("/users/{id}")User getUserById(@PathVariable("id") Long id);
}@Component
public class UserClientFallback implements UserServiceClient {@Overridepublic User getUserById(Long id) {// 返回一个默认的用户信息或者错误信息return new User(-1L, "服务不可用", "不可用");}
}

在这个例子中，fallback属性指定了一个降级类UserClientFallback。当user-service服务不可用时，Feign会自动调用这个类的getUserById方法，返回一个默认的用户信息。

5-2 .负载均衡

微服务架构中，一个服务可能有多个实例。Feign可以与Ribbon配合实现客户端负载均衡，自动选择一个服务实例来处理请求。Ribbon是一个客户端负载均衡器，可以根据不同的策略（如轮询、随机、响应时间加权等）来选择服务实例。

feign:client:config:default:connectTimeout: 5000readTimeout: 5000loggerLevel: full

在上述配置中，Feign客户端将使用Ribbon的默认配置来实现负载均衡。开发者无需编写额外的代码，Ribbon会自动处理服务实例的选择。

5-3. 日志记录

Feign提供了日志记录功能，可以帮助开发者调试和监控服务调用。Feign的日志级别可以配置为NONE、BASIC或FULL。

feign:client:config:default:loggerLevel: full

当设置为FULL级别时，Feign会记录请求和响应的详细信息，包括请求头、请求体、响应头和响应体。这对于调试问题和监控服务调用非常有用。

6 Feign与Hystrix的集成

微服务架构中，服务间的依赖可能导致级联故障，Hystrix为此提供了解决方案。Hystrix是一个延迟和容错库，它通过熔断机制来帮助系统在依赖服务失败时保持稳定。

6-1. Hystrix及其作用

Hystrix的核心功能是熔断机制，当一个服务调用失败率超过预设阈值时，Hystrix会“熔断”该服务的调用，直接返回错误，而不是让请求继续失败，这样可以防止系统过载。Hystrix还支持服务降级，当服务不可用时，可以快速返回一个合理的默认响应。

6-2. Feign与Hystrix集成

Feign可以与Hystrix无缝集成，以实现服务调用的熔断机制。集成过程非常简单，只需在Feign客户端接口中指定一个fallback类即可。

@FeignClient(name = "account-service", fallback = AccountServiceFallback.class)
public interface AccountServiceClient {@GetMapping("/accounts/{id}")Account getAccountById(@PathVariable("id") Long id);
}@Component
public class AccountServiceFallback implements AccountServiceClient {@Overridepublic Account getAccountById(Long id) {// 返回一个默认的Account对象或者错误信息return new Account(id, "账户服务不可用", "N/A");}
}

在上面的代码中，AccountServiceClient是一个Feign客户端接口，fallback属性指定了AccountServiceFallback类作为服务降级的实现。当account-service服务不可用时，Feign会自动调用AccountServiceFallback的getAccountById方法。

7 总结

回答一下前言里，我领导提到的问题，学起来，下次可以有理有据的回答出来了。（虽然直接说使用feign省工时，就能解决问题了～）

设计服务间通信时，选择Feign调用而不是直接HTTP调用的原因主要有以下几点：

1. 简化代码：Feign通过声明式接口简化了HTTP客户端的使用，开发者无需编写模板化的HTTP请求代码，如创建连接、设置请求头、处理响应等，这些都由Feign自动完成。
2. 提高开发效率：使用Feign，开发者可以像调用本地方法一样调用远程服务，这减少了编写和维护HTTP客户端代码的工作量，从而提高了开发效率。
3. 服务降级和熔断：Feign可以很容易地与Hystrix集成，实现服务降级和熔断机制，这有助于提高系统的容错能力，防止服务故障的级联效应。
4. 负载均衡：Feign与Ribbon集成，可以自动实现客户端负载均衡，无需手动指定服务实例，简化了服务调用的复杂性。
5. 编码器和解码器的灵活性：Feign支持自定义编码器和解码器，使得开发者可以根据需要处理请求和响应的序列化与反序列化，适应不同的数据传输需求。
6. 日志记录和监控：Feign提供了详细的日志记录功能，有助于调试和监控服务调用，这对于维护和优化服务间通信至关重要。
7. 错误处理：Feign允许定义全局和局部的错误处理策略，使得异常管理更加集中和一致。
8. 声明式REST客户端：Feign的声明式特性使得服务接口的定义与实现分离，提高了代码的可读性和可维护性。