Spring Cloud 入门系列四 -- 声明式调用组件 Feign 和客户端负载均衡器 Ribbon

最新推荐文章于 2025-07-24 21:28:43 发布

原创最新推荐文章于 2025-07-24 21:28:43 发布 · 321 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Spring Cloud

Spring Cloud 专栏收录该内容

11 篇文章

订阅专栏

本文介绍了Feign作为声明式HTTP客户端的使用方法，包括如何与Spring Cloud结合实现微服务间的调用，以及Ribbon如何在客户端实现负载均衡策略。通过实战演示了Feign与Ribbon的集成，展示了不同的负载均衡策略。

1 什么是 Feign？

Feign 是一个声明式的伪 HTTP 客户端，我们只需要创建一个接口并注解便可使用 Feign。它具有可插拔的注解特性，可使用 Feign 注解和 JAX-RS 注解，支持可插拔的编码器和解码器。Feign 默认集成了 Ribbon，并和 Eureka 结合，默认实现了负载均衡的效果。

2 入门实战

其实我已经在上一篇博客介绍过 Feign 了，具体实现代码可以参考上一篇博客，这里只是摘抄其中的一部分进行讲解。

package com.example.EurekaConsumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class EurekaConsumerApplication {

	public static void main(String[] args) {
		SpringApplication.run(EurekaConsumerApplication.class, args);
	}

}

如果我们需要使用 Feign 的功能，需要在启动类上添加 @EnableFeignClients 注解开启 Spring Cloud Feign 的支持功能。

package com.example.EurekaConsumer.Service;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Component
@FeignClient(name= "producer")//name为远程服务名，即远程服务spring.application.name设置的名字
public interface HelloWorldService {

	//调用方法需要与远程服务中的方法名和参数一致
	@RequestMapping("/helloWorld")
    public String helloWorld(@RequestParam(value = "id")int id,@RequestParam(value = "saying")String saying);
}

接口 @FeignClient 注解指定服务名来绑定服务，方法中我们使用了 Spring MVC 的注解来绑定具体服务提供的 REST 接口。

还有一个注意点，@FeignClient(name= "producer") 中的服务名是不区分大小写的。

3 负载均衡入门

负载均衡主要有两种方式，一是服务端负载算法，一是客户端负载算法。服务端算法在服务器端实现，主要是通过反向代理的方式把客户端请求分发到可用的节点，流程为客户端 -> 负载均衡服务器 -> 真正提供业务的服务器 -> 负载均衡服务器 -> 客户端，例如 Nginx。而客户端算法的负载均衡算法在客户端实现，在向服务器发起请求的时候，先执行算法计算出向哪台服务器发起请求，然后再发起请求给服务器，例如 Ribbon。

4 Ribbon 简介

Ribbon 是 Netflix 发布的云中间层服务开源项目，其主要功能是在客户端实现负载均衡算法。Ribbon 客户端组件提供一系列完善的配置项，例如连接超时，重试等。简单的说，Ribbon是一个客户端负载均衡器。

在 Spring Cloud 中，当 Ribbon 与 Eureka 配合使用时，Ribbon 可自动从 Eureka Server 获取服务提供者地址列表，并基于负载均衡算法，请求其中一个服务提供者实例。Ribbon 的工作分为两步：第一步选择 Eureka Server，它优先选择在同一个 Zone 且负载较少的 Server；第二步再根据用户指定的策略，再从 Server 取到的服务注册列表中选择一个地址。

Spring Cloud Feign 已经默认集成 Ribbon。

5 Ribbon 的负载均衡策略

Ribbon 一共有七种策略，下面我们分别对其进行介绍。

RoundRobinRule：即轮询策略，也是 Ribbon 的默认策略
RandomRule：即随机策略
BestAvailableRule：该策略会选择最小并发请求的服务器
AvailabilityFilteringRule：根据服务器状态进行选择
WeightedResponseTimeRule：根据响应时间进行选择
RetryRule：根据选定的负载均衡策略+重试机制
ZoneAvoidanceRule：根据 Zone 状态和服务状态进行选择

6 Ribbon 实战

由于 Spring Cloud Feign 已经默认集成 Ribbon，所以在 Feign 的基础上使用 Ribbon，不需要导入 Ribbon 的依赖。

我们的项目是在之前两篇博客基础之上实现的，所以建议没有看我前两篇博客的朋友先看一下。

我们再创建一个项目，项目名改为 EurekaProducerCopy，然后使用的端口改为 8083，其他的配置与我们之前的 EurekaProducer 一样即可。然后我们分别运行 Eureka，EurekaProducer，EurekaProducerCopy，EurekaConsumer 四个项目。

打开 Eureka 界面，我们发现现在有两个服务提供者。
在这里插入图片描述
在浏览器输入 http://localhost:8082/helloWorld?id=4&saying=%E7%89%9B%E9%80%BC 五次，其分别显示

来自8080端口:序号为4的用户发布了一条新消息:牛逼
来自8083端口:序号为4的用户发布了一条新消息:牛逼
来自8080端口:序号为4的用户发布了一条新消息:牛逼
来自8083端口:序号为4的用户发布了一条新消息:牛逼
来自8080端口:序号为4的用户发布了一条新消息:牛逼

我们发现两个结果交替出现，说明已经实现了服务均衡负载的功能，且客户端负载均衡器 Ribbon 的默认策略为轮询策略。

那如果我们想更改策略，例如切换为随机策略，又该怎么办呢？修改 EurekaConsumer 的配置文件，增加一行配置

# 使用随机策略,producer是作用到的微服务名
producer.ribbon.NFLoadBalancerRuleClassName=com.netflix.loadbalancer.RandomRule

现在我们重新运行项目，在浏览器输入 http://localhost:8082/helloWorld?id=4&saying=%E7%89%9B%E9%80%BC 五次，其结果显示如下：

来自8083端口:序号为4的用户发布了一条新消息:牛逼
来自8080端口:序号为4的用户发布了一条新消息:牛逼
来自8080端口:序号为4的用户发布了一条新消息:牛逼
来自8083端口:序号为4的用户发布了一条新消息:牛逼
来自8083端口:序号为4的用户发布了一条新消息:牛逼

我们可以发现，两个服务是随机调用的，说明我们的配置已经生效。