Skip to main content
Version: 当前版本

1. 概述

1.1 插件名称#

  • Hystrix插件

1.2 适用场景#

  • 服务不稳定,使用hystrix熔断保护服务

1.3 插件功能#

  • 熔断流量
  • 保护网关代理的服务
  • 隔离模式支持 threadsemaphore

1.4 插件代码#

  • 核心模块: shenyu-plugin-hystrix

  • 核心类: org.apache.shenyu.plugin.hystrix.HystrixPlugin

1.5 添加自哪个shenyu版本#

ShenYu 2.4.0

2. 如何使用插件

2.1 插件使用流程图#

2.2 导入pom#

  • 在网关的 pom.xml 文件中添加 hystrix的依赖。
<!-- apache shenyu hystrix plugin start--><dependency>  <groupId>org.apache.shenyu</groupId>  <artifactId>shenyu-spring-boot-starter-plugin-hystrix</artifactId>  <version>${project.version}</version></dependency><!-- apache shenyu hystrix plugin end-->

2.3 启用插件#

shenyu-admin --> 基础配置 --> 插件管理 --> hystrix 设置为开启。

2.4 配置插件#

2.4.1 插件配置#

  • 无配置,但你应该打开hystrix插件。

2.4.2 选择器配置#

用于对流量第一次筛选,不需要特殊处理字段。

关于选择器和规则配置的更多说明,请参考:选择器和规则管理, 这里只对部分字段进行了介绍。

2.4.3 规则配置#

用于对流量最终筛选,有规则处理逻辑,隔离模式支持 threadsemaphore

  • hystrix处理详解:

    • 跳闸最小请求数量:最小的请求量,至少要达到这个量才会触发熔断。

    • 错误百分比阀值: 这段时间内,发生异常的百分比。

    • 超时时间(ms):执行超时时间。

    • 最大并发量: 最大的并发量。

    • 跳闸休眠时间(ms):熔断以后恢复的时间。

    • 分组Key: 一般设置为:contextPath

    • 失败降级URL: 默认为 /fallback/hystrix

    • 命令Key: 一般设置为具体的路径接口。

2.5 示例#

2.5.1 使用hystrix熔断保护服务#

2.5.1.1 准备工作#

  • 启动 ShenYu Admin
  • 启动 ShenYu Bootstrap
  • 启动一个后端服务

2.5.1.2 选择器配置#

2.5.1.3 规则配置#

  • 以下图片的规则仅为测试使用,实际情况取决于特定的场景而定。

  • 测试案例
@RestController@RequestMapping("/test")@ShenyuSpringMvcClient("/test/**")public class HttpTestController {    @PostMapping("/testHystrix")    public ResultBean ok() {        Random random = new Random();        int num = random.nextInt(100);        if (num > 20) {            throw new RuntimeException();        }        return new ResultBean(200, "ok", null);    }}

2.5.1.4 使用Apache Jmeter发送请求#

2.5.1.5 验证结果#

3. 如何禁用插件

shenyu-admin --> 基础配置 --> 插件管理 --> hystrix 设置为关闭。