Spring Cloud Feign 整合 Sentinel 实现服务降级与熔断保护

述雾学java2025-07-06 13:01

Spring Cloud Feign 整合 Sentinel 实现服务降级与熔断保护

在微服务架构中，服务之间的调用往往依赖 Feign，而服务调用的稳定性又至关重要。本文将介绍如何将 Feign 与 Sentinel 结合使用，实现服务的容错保护（如降级与熔断），提升系统的健壮性与可用性。

一、引入依赖

我们创建一个新的微服务，作为 Feign 调用方。pom.xml 中添加如下依赖：

xml 复制代码 
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2.2.1.RELEASE</version>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
    <version>2.2.1.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.2.2.RELEASE</version>
</dependency>

二、配置 application.yml

在配置文件中开启 Feign 对 Sentinel 的支持，并配置基本信息：

yaml 复制代码 
server:
  port: 8380

feign:
  sentinel:
    enabled: true  # 开启 Sentinel 对 Feign 的支持

spring:
  application:
    name: feign
  cloud:
    sentinel:
      transport:
        dashboard: localhost:8080  # Sentinel 控制台地址
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848  # Nacos 注册中心地址

三、创建 Feign 接口

我们通过 Feign 调用名为 provider 的服务：

java 复制代码 
package com.southwind.feign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient("provider")
public interface ProviderFeign {
    
    @GetMapping("/index")
    String index();
}

四、编写 Controller

通过注入 Feign 接口，实现接口调用：

java 复制代码 
package com.southwind.controller;

import com.southwind.feign.ProviderFeign;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignController {

    @Autowired
    private ProviderFeign providerFeign;

    @GetMapping("/index")
    public String index(){
        return providerFeign.index();
    }
}

五、自定义 Fallback 实现服务降级

当服务不可用或 Sentinel 触发熔断时，我们希望返回友好的降级提示，这就需要自定义 fallback 类：

1. 创建 fallback 实现类

java 复制代码 
package com.southwind.fallback;

import com.southwind.feign.ProviderFeign;
import org.springframework.stereotype.Component;

@Component
public class ProviderFeignFallback implements ProviderFeign {
    @Override
    public String index() {
        return "index-fallback";
    }
}

2. 修改 FeignClient 注解，指定 fallback

java 复制代码 
package com.southwind.feign;

import com.southwind.fallback.ProviderFeignFallback;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(value = "provider", fallback = ProviderFeignFallback.class)
public interface ProviderFeign {

    @GetMapping("/index")
    String index();
}

Spring Cloud Feign 整合 Sentinel 实现服务降级与熔断保护

在微服务架构中，服务之间的调用往往依赖 Feign，而服务调用的稳定性又至关重要。本文将介绍如何将 Feign 与 Sentinel 结合使用，实现服务的容错保护（如降级与熔断），提升系统的健壮性与可用性。

一、引入依赖

我们创建一个新的微服务，作为 Feign 调用方。pom.xml 中添加如下依赖：

xml 复制代码 
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2.2.1.RELEASE</version>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
    <version>2.2.1.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.2.2.RELEASE</version>
</dependency>

二、配置 application.yml

在配置文件中开启 Feign 对 Sentinel 的支持，并配置基本信息：

yaml 复制代码 
server:
  port: 8380

feign:
  sentinel:
    enabled: true  # 开启 Sentinel 对 Feign 的支持

spring:
  application:
    name: feign
  cloud:
    sentinel:
      transport:
        dashboard: localhost:8080  # Sentinel 控制台地址
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848  # Nacos 注册中心地址

三、创建 Feign 接口

我们通过 Feign 调用名为 provider 的服务：

java 复制代码 
package com.southwind.feign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient("provider")
public interface ProviderFeign {
    
    @GetMapping("/index")
    String index();
}

四、编写 Controller

通过注入 Feign 接口，实现接口调用：

java 复制代码 
package com.southwind.controller;

import com.southwind.feign.ProviderFeign;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignController {

    @Autowired
    private ProviderFeign providerFeign;

    @GetMapping("/index")
    public String index(){
        return providerFeign.index();
    }
}

五、自定义 Fallback 实现服务降级

当服务不可用或 Sentinel 触发熔断时，我们希望返回友好的降级提示，这就需要自定义 fallback 类：

1. 创建 fallback 实现类

java 复制代码 
package com.southwind.fallback;

import com.southwind.feign.ProviderFeign;
import org.springframework.stereotype.Component;

@Component
public class ProviderFeignFallback implements ProviderFeign {
    @Override
    public String index() {
        return "index-fallback";
    }
}

2. 修改 FeignClient 注解，指定 fallback

java 复制代码 
package com.southwind.feign;

import com.southwind.fallback.ProviderFeignFallback;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(value = "provider", fallback = ProviderFeignFallback.class)
public interface ProviderFeign {

    @GetMapping("/index")
    String index();
}

3.启动类添加@EnableFeignClients注解

java 复制代码 
@SpringBootApplication
@EnableFeignClients
public class FeignApplication {

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

}

六、运行与测试

  1. 启动 Sentinel Dashboard（默认端口为 8080）。
  2. 启动被调用服务 provider。
  3. 启动当前项目 feign。
  4. 浏览器访问：http://localhost:8380/index
  5. 停止 provider 服务，再次访问，即返回 fallback 内容：index-fallback。

七、总结

模块 说明
Feign 简化 HTTP 请求调用
Sentinel 实现限流、熔断与降级保护
fallback 实现服务不可用时的降级逻辑
配置关键点 开启 feign.sentinel.enabled=true 并配置 fallback

通过本文的实践，我们实现了 Feign + Sentinel 的无缝集成，使服务调用具备更强的容错能力。建议大家在生产环境中为每个 Feign 接口都配置 fallback，防止服务雪崩。

如有帮助，欢迎点赞、评论、收藏！

后续将分享更多微服务高可用相关内容，敬请关注。

六、运行与测试

  1. 启动 Sentinel Dashboard（默认端口为 8080）。
  2. 启动被调用服务 provider。
  3. 启动当前项目 feign。
  4. 浏览器访问：http://localhost:8380/index
  5. 停止 provider 服务，再次访问，即返回 fallback 内容：index-fallback。

七、总结

模块 说明
Feign 简化 HTTP 请求调用
Sentinel 实现限流、熔断与降级保护
fallback 实现服务不可用时的降级逻辑
配置关键点 开启 feign.sentinel.enabled=true 并配置 fallback

通过本文的实践，我们实现了 Feign + Sentinel 的无缝集成，使服务调用具备更强的容错能力。建议大家在生产环境中为每个 Feign 接口都配置 fallback，防止服务雪崩。

如有帮助，欢迎点赞、评论、收藏！

后续将分享更多微服务高可用相关内容，敬请关注。

相关推荐
毕设源码-朱学姐18 小时前
【开题答辩全过程】以 基于JavaWeb的网上家具商城设计与实现为例，包含答辩的问题和答案
java
C雨后彩虹19 小时前
CAS与其他并发方案的对比及面试常见问题
java·面试·cas·同步·异步·锁
java1234_小锋20 小时前
Java高频面试题：SpringBoot为什么要禁止循环依赖?
java·开发语言·面试
2501_9445255421 小时前
Flutter for OpenHarmony 个人理财管理App实战 - 账户详情页面
android·java·开发语言·前端·javascript·flutter
计算机学姐21 小时前
基于SpringBoot的电影点评交流平台【协同过滤推荐算法+数据可视化统计】
java·vue.js·spring boot·spring·信息可视化·echarts·推荐算法
Filotimo_21 小时前
Tomcat的概念
java·tomcat
索荣荣21 小时前
Java Session 全面指南：原理、应用与实践（含 Spring Boot 实战）
java·spring boot·后端
Amumu121381 天前
Vue Router(二)
java·前端
念越1 天前
数据结构：栈堆
java·开发语言·数据结构
热门推荐
01GitHub 镜像站点02Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services03Vue-skills的中文文档04让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南05Claude Code Skills 实用使用手册06一文了解国产算子编程语言 TileLang，TileLang 对国产开源生态的影响与启示07UV安装并设置国内源08OpenClaw Chrome扩展使用教程 - 浏览器中继控制09Linux下V2Ray安装配置指南10AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南