1. 概述

1.1 插件名称

• Hystrix插件

1.2 适用场景

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

1.3 插件功能

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

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 规则配置

用于对流量最终筛选，有规则处理逻辑，隔离模式支持 thread 和 semaphore 。

• hystrix处理详解：

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

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

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

  • 跳闸休眠时间(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 设置为关闭。