为了账号安全，请及时绑定邮箱和手机立即绑定
首页 手记 Sentinel+Feign熔断降级处理资料详解

Sentinel+Feign熔断降级处理资料详解

标签：
架构 Spring Cloud 微服务
概述

本文详细介绍了Sentinel与Feign的集成，讲解了如何通过Sentinel实现对Feign服务的熔断降级保护，涵盖流量控制、熔断降级和系统负载保护等多个方面，提供了丰富的示例代码和配置方法。Sentinel+Feign熔断降级处理资料在文章中得到了全面的展示和应用。

Sentinel与Feign的基本概念
Sentinel简介

Sentinel 是阿里巴巴开源的一款分布式服务保护框架，主要提供流量控制、熔断降级和系统负载保护等功能。Sentinel 的设计目标是提供简单易用、高可用且分布式的流量控制和保护方案。它具有以下特性：

  1. 流量控制：基于规则对请求进行流量控制，可以设置每秒请求数量、并发线程数等，以保障系统在负载压力下的稳定性。
  2. 熔断降级：当某个服务不稳定时，可以自动熔断该服务并提供降级策略，以避免连锁反应导致整个系统崩溃。
  3. 系统负载保护：根据系统的实时状态（如CPU使用率、线程池状态等）动态调整流量以保护系统。
  4. 聚合监控：实时监控和展示系统监控数据，帮助开发人员迅速定位问题。

示例代码

以下是一个简单的示例，展示如何配置Sentinel的基本依赖：

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-spring-boot-starter</artifactId>
    <version>1.8.3</version>
</dependency>

在 application.yml 中进行基本配置：

spring:
  application:
   name: sentinel-feign-sample

sentinel:
  transport:
   dashboard: localhost:8080
Feign简介

Feign 是一个声明式的 Web 服务客户端，它使得编写 Web 服务客户端变得更简单。Feign 可以做到 HTTP 请求与 POJO 方法的映射，提供了强大的注解支持，可以声明式地调用服务，而不需要显式地进行 HTTP 请求的编码和解码。Feign 能够与多种 HTTP 客户端库集成，最常见的就是与 Ribbon 集成来实现服务发现和负载均衡。

Feign 的主要特点如下：

  1. 声明式调用：使用注解的方式直接定义服务接口，简化了客户端的代码。
  2. 可扩展性强：支持添加拦截器和过滤器，可以轻松地扩展其功能。
  3. 集成其他库：例如，与 Spring Cloud 的 Ribbon 和 Hystrix 集成可以实现服务发现和熔断降级。
  4. 支持多种注解：包括 Spring 的 @RequestMapping 和 @GetMapping 等。

示例代码

以下是一个简单的示例，展示如何引入Feign依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
Sentinel与Feign集成的作用

Sentinel 与 Feign 结合使用，可以为基于 Feign 的分布式服务提供更强大的保护能力。通过 Sentinel 的流量控制、熔断降级和系统负载保护等特性，可以在分布式环境中更好地控制和保护服务，防止因单一服务的不稳定导致整个系统崩溃。具体来说：

  1. 流量控制：可以限制 Feign 客户端每秒的请求数量，避免服务压力过大。
  2. 熔断降级：当服务出现故障时，Sentinel 可以自动熔断该服务，并提供降级策略，避免连锁反应。
  3. 负载保护：根据系统实时状态动态调整流量，防止过载。
熔断降级的基本原理
熔断降级概念

熔断降级是一种服务保护机制，当某个服务不可用或响应过慢时，熔断器会自动打开，暂时中断该服务的调用，以防止错误的放大。熔断器在一段时间后会自动恢复（半熔断状态），如果恢复失败，则会进入全熔断状态，并触发降级策略。

熔断降级机制

熔断降级机制通常包括以下几个步骤：

  1. 检测阶段：在正常情况下，服务调用会正常进行。如果在一段时间内连续出现超时、异常等情况，则进入检测阶段。
  2. 熔断打开：达到一定错误率阈值时，熔断器会打开，停止服务调用，避免错误的放大。
  3. 半熔断恢复：经过一段时间（通常是熔断阈值时间），熔断器进入半熔断状态，允许部分请求通过，以监控服务是否已经恢复。
  4. 全熔断恢复：如果在半熔断状态下服务仍然不稳定，则进入全熔断状态，并触发降级策略。
  5. 降级策略：当服务熔断后，可以提供一个备用方案，例如返回默认值或使用缓存等。
Sentinel实现熔断降级的方法

Sentinel 使用熔断降级机制来保护分布式服务，主要通过规则配置来实现。Sentinel 提供了丰富的熔断降级规则，包括慢调用比例阈值、异常比例阈值、异常数阈值等。这些规则可以针对不同的服务接口进行配置，以满足不同的保护需求。

示例代码

以下是一个简单的示例，展示如何在 Sentinel 中配置熔断降级规则：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

@RestController
public class SentinelController {

    @Autowired
    private SentinelService sentinelService;

    @GetMapping("/test")
    @SentinelResource(value = "testResource", blockHandler = "customBlockHandler")
    public String test() {
        return sentinelService.test();
    }

    public String customBlockHandler(BlockException ex) {
        return "熔断降级触发";
    }

    public void initRules() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("testResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rule.setWarmUpPeriodMs(3000);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }
}

说明

  1. @SentinelResource 注解用于标记需要保护的服务接口。
  2. customBlockHandler 方法用于定义熔断降级后的返回值。
  3. FlowRuleManager.loadRules 方法用于加载熔断规则，限制资源 testResource 的每秒请求数量。
Sentinel与Feign集成的步骤
安装与配置Sentinel

要在项目中集成 Sentinel，首先需要在 pom.xml 文件中添加 Sentinel 依赖：

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-spring-boot-starter</artifactId>
    <version>1.8.3</version>
</dependency>

之后，在 application.yml 中进行一些基本配置：

spring:
  application:
   name: sentinel-feign-sample

sentinel:
  transport:
   dashboard: localhost:8080

上述配置文件指定了 Sentinel 与 Dashboard 之间的通信端口和地址。

引入Feign依赖

在 pom.xml 文件中引入 Feign 以及 Spring Cloud 依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
集成Sentinel与Feign

为了将 Sentinel 与 Feign 集成，需要在启动类上添加 @EnableFeignClients 和 @EnableSentinel 注解：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableFeignClients
public class SentinelFeignApplication {

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

同时，需要在 Feign 客户端中添加 @SentinelResource 注解以启用熔断降级保护：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient("service-provider")
public interface FeignClientService {

    @GetMapping("/sayHello")
    @SentinelResource("sayHelloResource")
    String sayHello();

}

示例代码

以下是一个完整的 Feign 客户端接口定义示例：

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

@FeignClient("service-provider")
public interface SampleServiceClient {

    @GetMapping("/test")
    String test();

}
Sentinel熔断降级的具体实现
创建Feign客户端

首先，创建一个 Feign 客户端接口：

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

@FeignClient("service-provider")
public interface SampleServiceClient {

    @GetMapping("/test")
    String test();

}
配置熔断降级规则

接下来，在项目中配置熔断降级规则。这里使用 @SentinelResource 注解来标记需要保护的方法，并定义熔断降级后的处理逻辑：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SentinelController {

    @Autowired
    private SampleServiceClient sampleServiceClient;

    @GetMapping("/test")
    @SentinelResource(value = "testResource", blockHandler = "customBlockHandler")
    public String test() {
        return sampleServiceClient.test();
    }

    public String customBlockHandler(BlockException ex) {
        return "熔断降级触发";
    }

    public void initRules() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("testResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rule.setWarmUpPeriodMs(3000);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }
}

示例代码

以下是一个完整的熔断降级规则配置示例：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

@RestController
public class SentinelController {

    @Autowired
    private SampleServiceClient sampleServiceClient;

    @GetMapping("/test")
    @SentinelResource(value = "testResource", blockHandler = "customBlockHandler")
    public String test() {
        return sampleServiceClient.test();
    }

    public String customBlockHandler(BlockException ex) {
        return "熔断降级触发";
    }

    public void initRules() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("testResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rule.setWarmUpPeriodMs(3000);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }
}

说明

  1. @SentinelResource 注解用于标记需要保护的服务接口。
  2. customBlockHandler 方法用于定义熔断降级后的返回值。
  3. FlowRuleManager.loadRules 方法用于加载熔断规则，限制资源 testResource 的每秒请求数量。
测试熔断降级功能

为了测试熔断降级功能，可以模拟服务异常情况，例如通过人为控制 sampleServiceClient 的返回值。下面是一个示例代码，用于模拟异常情况：

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

@FeignClient("service-provider")
public interface SampleServiceClient {

    @GetMapping("/test")
    String test();

    // 模拟异常情况
    default String testWithException() {
        try {
            throw new RuntimeException("模拟异常");
        } catch (RuntimeException e) {
            return "异常发生";
        }
    }

}

可以修改 SentinelController 类中的 test 方法，调用 testWithException 方法来触发熔断降级：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

@RestController
public class SentinelController {

    @Autowired
    private SampleServiceClient sampleServiceClient;

    @GetMapping("/test")
    @SentinelResource(value = "testResource", blockHandler = "customBlockHandler")
    public String test() {
        return sampleServiceClient.testWithException();
    }

    public String customBlockHandler(BlockException ex) {
        return "熔断降级触发";
    }

    public void initRules() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("testResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rule.setWarmUpPeriodMs(3000);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }
}

通过上述代码，可以观察到在触发异常时，熔断降级机制会被触发，并返回预定义的降级策略。

常见问题与解决方法
常见错误及解决方案

在实际使用过程中，可能会遇到以下一些常见的问题：

  1. 熔断降级规则未生效：请检查是否正确配置了 @SentinelResource 注解，并且发送了足够的请求触发规则。
  2. 规则加载失败：确保 FlowRuleManager.loadRules 方法正确加载了规则。
  3. 无法加载 Sentinel 配置文件：检查 application.yml 文件中是否正确配置了 Sentinel 的相关参数。
  4. Feign 客户端调用失败：确认 Feign 客户端的 @FeignClient 注解中服务名称是否正确，以及服务提供者是否正常运行。

示例代码

以下是一个简单的示例，展示如何配置和解决上述常见错误：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

@RestController
public class SentinelController {

    @Autowired
    private SampleServiceClient sampleServiceClient;

    @GetMapping("/test")
    @SentinelResource(value = "testResource", blockHandler = "customBlockHandler")
    public String test() {
        return sampleServiceClient.test();
    }

    public String customBlockHandler(BlockException ex) {
        return "熔断降级触发";
    }

    public void initRules() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("testResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rule.setWarmUpPeriodMs(3000);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }
}
经验分享与最佳实践
  1. 合理配置熔断降级规则：根据系统的实际负载情况，合理设置熔断降级的阈值和恢复时间，避免频繁的熔断和恢复。
  2. 监控和日志：使用 Sentinel 的监控功能，实时监控服务的状态和异常情况，及时发现并处理问题。
  3. 测试和演练：定期进行系统演练和压力测试，确保在真实情况下熔断降级机制能够正常工作。
总结与展望
本章小结

本章详细介绍了 Sentinel 和 Feign 的基本概念，以及它们如何结合使用来实现熔断降级功能。通过示例代码，展示了如何配置和测试熔断降级规则，帮助读者更好地理解和应用相关技术。

Sentinel与Feign的发展趋势

随着微服务架构的普及，对服务保护的需求越来越高。Sentinel 作为一款高性能的服务保护框架，其在流量控制、熔断降级和系统负载保护等方面的优势将使其在未来的微服务架构中扮演更加重要的角色。Feign 作为一款声明式 Web 服务客户端，其简洁和强大的功能也将继续被广泛使用。未来，Sentinel 和 Feign 的集成将更加紧密，提供更多的功能和更好的用户体验。

推荐编程学习网站可以参考慕课网（https://www.imooc.com/），了解更多关于 Sentinel 和 Feign 的详细教程和技术资料。

点击查看更多内容
发表于 2025.01.02 17:40， 共 37 人浏览

本文原创发布于慕课网 ，转载请注明出处，谢谢合作

举报
为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

作者其他优质文章

正在加载中

慕标5832272

全栈工程师
手记
篇
粉丝
231
获赞与收藏
1002

关注作者，订阅最新文章

阅读免费教程

  • 推荐
  • 评论
  • 收藏
  • 共同学习，写下你的评论
感谢您的支持，我会继续努力的～
扫码打赏，你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫，即可进行扫码打赏哦
今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与 放弃机会
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消