SpringCloud Hystrix服务熔断实例总结

SpringCloud Hystrix断路器-服务熔断与降级和HystrixDashboard
SpringCloud Hystrix服务降级实例总结

本文采用版本为Hoxton.SR1系列，SpringBoot为2.2.2.RELEASE

<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>Hoxton.SR1</version>
</dependency><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>

【1】服务熔断

熔断机制概述

熔断机制是应对雪崩效应的一种微服务链路保护机制。当扇出链路的某个微服务出错不可用或者响应时间太长时，会进行服务的降级，进而熔断该节点微服务的调用，快速返回错误的响应信息。

当检测到该节点微服务调用响应正常后，恢复调用链路。

在Spring Cloud框架里，熔断机制通过Hystrix实现。Hystrix会监控微服务间调用的状况，当失败的调用到一定阈值，缺省是10秒内20次调用失败率达到50%，就会启动熔断机制。熔断机制的注解是@HystrixCommand。

关于服务熔断可以参考大神论文：https://martinfowler.com/bliki/CircuitBreaker.html

【2】服务降级和服务熔断区别

在Hystrix中，服务降级（Service Degradation）和服务熔断（Circuit Breaker）是两种不同的容错机制，它们分别用于处理不同的场景和问题。下面是它们的主要区别：

① 服务熔断 (Circuit Breaker)

服务熔断的概念源于电力工程中的断路器，它用于防止电路过载。在软件系统中，当检测到某个依赖服务出现问题时，断路器会“打开”，阻止进一步的请求到达故障服务，从而避免了请求的堆积和资源的无效消耗。一旦断路器打开，Hystrix会直接调用降级逻辑，而不是尝试调用故障服务，直到断路器再次关闭。

• 触发原因：服务熔断通常是因为下游服务出现故障，比如响应时间过长、频繁失败或完全不可达。也就是当某服务调用失败达到一定次数或比例时，断路器会打开
• 目的：保护调用者不受故障服务影响，防止调用者因为等待无响应的服务而浪费资源（如线程）。
• 机制：当检测到故障模式时，熔断器将“打开”，直接拒绝后续的请求，而不是尝试调用可能失败的服务。这有助于避免故障传播，并且可以提供快速失败响应，让调用者可以立即知道调用失败。
• 状态转换：断路器有三个状态：关闭（Closed）、打开（Open）和半开（Half-Open）。当故障消除一段时间后，断路器会进入半开状态，允许小部分请求尝试调用，如果成功，则关闭断路器，否则再次打开。

② 服务降级 (Service Degradation)

服务降级是在系统整体负荷过高或服务出现异常时，提供一种退而求其次的处理方式。它通常发生在系统资源紧张或为了防止系统过载的情况下。降级逻辑通常会提供一个静态的、预计算的或简化的响应，以代替完整服务的调用。

• 触发原因：服务降级通常是在系统整体负荷较高或资源紧张时触发，旨在优先处理关键请求或减轻系统压力。
• 目的：通过提供一个简化的或降级的服务版本，确保核心功能仍然可用，同时避免系统过载。
• 机制：当系统检测到负载过高或其他降级条件时，会执行预先定义的降级逻辑，这通常涉及到提供一个静态的、预计算的或低质量的响应，而不是尝试调用完整的服务。
• 代码侵入性：服务降级往往需要在应用层面上明确实现，例如编写降级逻辑或fallback方法，以便在正常服务无法满足时调用。

③ 总结

• 服务熔断是一种自动化的故障隔离机制，用于快速响应故障服务调用，防止调用者线程池被耗尽。

• 服务降级是根据系统状态动态调整服务级别的一种策略，用于在资源受限时提供基础服务，避免系统过载。

• 服务降级每次都会先调用原服务方法，调用失败才会执行服务降级方法；服务熔断状态会直接调用服务降级方法。

在实践中，两者常常结合使用，以构建更具弹性和健壮性的分布式系统。Hystrix作为一个容错库，提供了这些机制的实现，允许开发者在微服务架构中更好地控制故障处理和资源管理。

【3】@HystrixCommand熔断实例

服务提供方的方法上使用@HystrixCommand进行配置，如下所示（在10s内的10次请求中如果失败超过6次进入服务熔断）：

// 服务熔断
@HystrixCommand(fallbackMethod = "paymentInfo_Circuit",commandProperties = {@HystrixProperty(name="circuitBreaker.enabled",value = "true"),//是否开启断路器@HystrixProperty(name="circuitBreaker.requestVolumeThreshold",value = "10"),// 请求次数@HystrixProperty(name="circuitBreaker.sleepWindowInMilliseconds",value = "5000"),// 休眠时间窗口期@HystrixProperty(name="circuitBreaker.errorThresholdPercentage",value = "60")// 失败率// 加起来就是在10s内的10次请求中如果失败超过6次进入服务熔断
})
public String paymentCircuitBreaker(@PathVariable("id") Integer id){if (id<0){throw new RuntimeException("id 不能为负数");}String serialNumber = IdUtil.simpleUUID();return "调用成功："+serialNumber;
}public String paymentInfo_Circuit(Integer id){return "id不能为负数："+id;
}

关于sleepWindowInMilliseconds：sleepWindow: 5000 = 5 seconds that we will sleep before trying again after tripping the circuit。也就是跳闸后休眠5秒会再次重试服务。

这些属性的key和默认值可以在HystrixCommandProperties类中看到，主启动类配置注解@EnableCircuitBreaker。

【4】总结分析

① 熔断类型

熔断打开：请求不再进行调用当前服务，内部设置时钟一般为MTTR（平均故障处理时间)，当打开时长达到所设时钟则进入半熔断状态。

熔断关闭：熔断关闭不会对服务进行熔断

熔断半开：部分请求根据规则调用当前服务，如果请求成功且符合规则则认为当前服务恢复正常，关闭熔断

② 官网说明

① 官网断路器流程图

② 官网步骤

③ 断路器在什么情况下开始起作用

涉及到断路器的三个重要参数：快照时间窗、请求总数阀值、错误百分比阀值。

1. 快照时间窗：断路器确定是否打开需要统计一些请求和错误数据，而统计的时间范围就是快照时间窗，默认为最近的10秒。
2. 请求总数阀值：在快照时间窗内，必须满足请求总数阀值才有资格熔断。默认为20，意味着在10秒内，如果该hystrix命令的调用次数不足20次，即使所有的请求都超时或其他原因失败，断路器都不会打开。
3. 错误百分比阀值：当请求总数在快照时间窗内超过了阀值，比如发生了30次调用，如果在这30次调用中，有15次发生了超时异常，也就是超过50%的错误百分比，在默认设定50%阀值情况下，这时候就会将断路器打开。

上述中的默认值是Hystrix中HystrixCommandProperties提供的默认值。

④ 断路器开启或者关闭的条件

• 当满足一定的阀值的时候（默认10秒内超过20个请求次数）
• 当失败率达到一定的时候（默认10秒内超过50%的请求失败）
• 到达以上阀值，断路器将会开启，当开启的时候，所有请求都不会进行转发
• 一段时间之后（默认是5秒），这个时候断路器是半开状态，会让其中一个请求进行转发。如果成功，断路器会关闭，若失败，继续开启。重复步骤

⑤ 断路器打开之后会发生什么

1：再有请求调用的时候，将不会调用主逻辑，而是直接调用降级fallback。通过断路器，实现了自动地发现错误并将降级逻辑切换为主逻辑，减少响应延迟的效果。

2：原来的主逻辑要如何恢复呢？

对于这一问题，hystrix也为我们实现了自动恢复功能。

当断路器打开，对主逻辑进行熔断之后，hystrix会启动一个休眠时间窗，在这个时间窗内，降级逻辑是临时的成为主逻辑。

当休眠时间窗到期，断路器将进入半开状态，释放一次请求到原来的主逻辑上，如果此次请求正常返回，那么断路器将继续闭合
主逻辑恢复，如果这次请求依然有问题，断路器继续进入打开状态，休眠时间窗重新计时。

【5】 参考配置

//========================All
@HystrixCommand(fallbackMethod = "str_fallbackMethod",groupKey = "strGroupCommand",commandKey = "strCommand",threadPoolKey = "strThreadPool",commandProperties = {// 设置隔离策略，THREAD 表示线程池 SEMAPHORE：信号池隔离@HystrixProperty(name = "execution.isolation.strategy", value = "THREAD"),// 当隔离策略选择信号池隔离的时候，用来设置信号池的大小（最大并发数）@HystrixProperty(name = "execution.isolation.semaphore.maxConcurrentRequests", value = "10"),// 配置命令执行的超时时间@HystrixProperty(name = "execution.isolation.thread.timeoutinMilliseconds", value = "10"),// 是否启用超时时间@HystrixProperty(name = "execution.timeout.enabled", value = "true"),// 执行超时的时候是否中断@HystrixProperty(name = "execution.isolation.thread.interruptOnTimeout", value = "true"),// 执行被取消的时候是否中断@HystrixProperty(name = "execution.isolation.thread.interruptOnCancel", value = "true"),// 允许回调方法执行的最大并发数@HystrixProperty(name = "fallback.isolation.semaphore.maxConcurrentRequests", value = "10"),// 服务降级是否启用，是否执行回调函数@HystrixProperty(name = "fallback.enabled", value = "true"),// 是否启用断路器@HystrixProperty(name = "circuitBreaker.enabled", value = "true"),// 该属性用来设置在滚动时间窗中，断路器熔断的最小请求数。例如，默认该值为 20 的时候，// 如果滚动时间窗（默认10秒）内仅收到了19个请求， 即使这19个请求都失败了，断路器也不会打开。@HystrixProperty(name = "circuitBreaker.requestVolumeThreshold", value = "20"),// 该属性用来设置在滚动时间窗中，表示在滚动时间窗中，在请求数量超过// circuitBreaker.requestVolumeThreshold 的情况下，如果错误请求数的百分比超过50,// 就把断路器设置为 "打开" 状态，否则就设置为 "关闭" 状态。@HystrixProperty(name = "circuitBreaker.errorThresholdPercentage", value = "50"),// 该属性用来设置当断路器打开之后的休眠时间窗。 休眠时间窗结束之后，// 会将断路器置为 "半开" 状态，尝试熔断的请求命令，如果依然失败就将断路器继续设置为 "打开" 状态，// 如果成功就设置为 "关闭" 状态。@HystrixProperty(name = "circuitBreaker.sleepWindowinMilliseconds", value = "5000"),// 断路器强制打开@HystrixProperty(name = "circuitBreaker.forceOpen", value = "false"),// 断路器强制关闭@HystrixProperty(name = "circuitBreaker.forceClosed", value = "false"),// 滚动时间窗设置，该时间用于断路器判断健康度时需要收集信息的持续时间@HystrixProperty(name = "metrics.rollingStats.timeinMilliseconds", value = "10000"),// 该属性用来设置滚动时间窗统计指标信息时划分"桶"的数量，断路器在收集指标信息的时候会根据// 设置的时间窗长度拆分成多个 "桶" 来累计各度量值，每个"桶"记录了一段时间内的采集指标。// 比如 10 秒内拆分成 10 个"桶"收集这样，所以 timeinMilliseconds 必须能被 numBuckets 整除。否则会抛异常@HystrixProperty(name = "metrics.rollingStats.numBuckets", value = "10"),// 该属性用来设置对命令执行的延迟是否使用百分位数来跟踪和计算。如果设置为 false, 那么所有的概要统计都将返回 -1。@HystrixProperty(name = "metrics.rollingPercentile.enabled", value = "false"),// 该属性用来设置百分位统计的滚动窗口的持续时间，单位为毫秒。@HystrixProperty(name = "metrics.rollingPercentile.timeInMilliseconds", value = "60000"),// 该属性用来设置百分位统计滚动窗口中使用 “ 桶 ”的数量。@HystrixProperty(name = "metrics.rollingPercentile.numBuckets", value = "60000"),// 该属性用来设置在执行过程中每个 “桶” 中保留的最大执行次数。如果在滚动时间窗内发生超过该设定值的执行次数，// 就从最初的位置开始重写。例如，将该值设置为100, 滚动窗口为10秒，若在10秒内一个 “桶 ”中发生了500次执行，// 那么该 “桶” 中只保留 最后的100次执行的统计。另外，增加该值的大小将会增加内存量的消耗，并增加排序百分位数所需的计算时间。@HystrixProperty(name = "metrics.rollingPercentile.bucketSize", value = "100"),// 该属性用来设置采集影响断路器状态的健康快照（请求的成功、 错误百分比）的间隔等待时间。@HystrixProperty(name = "metrics.healthSnapshot.intervalinMilliseconds", value = "500"),// 是否开启请求缓存@HystrixProperty(name = "requestCache.enabled", value = "true"),// HystrixCommand的执行和事件是否打印日志到 HystrixRequestLog 中@HystrixProperty(name = "requestLog.enabled", value = "true"),},threadPoolProperties = {// 该参数用来设置执行命令线程池的核心线程数，该值也就是命令执行的最大并发量@HystrixProperty(name = "coreSize", value = "10"),// 该参数用来设置线程池的最大队列大小。当设置为 -1 时，线程池将使用 SynchronousQueue 实现的队列，// 否则将使用 LinkedBlockingQueue 实现的队列。@HystrixProperty(name = "maxQueueSize", value = "-1"),// 该参数用来为队列设置拒绝阈值。 通过该参数， 即使队列没有达到最大值也能拒绝请求。// 该参数主要是对 LinkedBlockingQueue 队列的补充,因为 LinkedBlockingQueue// 队列不能动态修改它的对象大小，而通过该属性就可以调整拒绝请求的队列大小了。@HystrixProperty(name = "queueSizeRejectionThreshold", value = "5"),}
)
public String strConsumer() {return "hello jane";
}
public String str_fallbackMethod()
{return "*****fall back str_fallbackMethod";
}

【7】Hystrix 工作流程

官网地址：https://github.com/Netflix/Hystrix/wiki/How-it-Works

1 创建 HystrixCommand（用在依赖的服务返回单个操作结果的时候） 或 HystrixObserableCommand（用在依赖的服务返回多个操作结果的时候） 对象。

2 命令执行。其中 HystrixComand 实现了下面前两种执行方式；而 HystrixObservableCommand 实现了后两种执行方式。

• execute()：同步执行，从依赖的服务返回一个单一的结果对象， 或是在发生错误的时候抛出异常。
• queue()：异步执行， 直接返回 一个Future对象， 其中包含了服务执行结束时要返回的单一结果对象。
• observe()：返回 Observable 对象，它代表了操作的多个结果，它是一个 Hot Obserable（不论 “事件源” 是否有 “订阅者”，都会在创建后对事件进行发布，所以对于 Hot Observable 的每一个 “订阅者” 都有可能是从 “事件源” 的中途开始的，并可能只是看到了整个操作的局部过程）。
• toObservable()： 同样会返回 Observable 对象，也代表了操作的多个结果，但它返回的是一个Cold Observable（没有 “订阅者” 的时候并不会发布事件，而是进行等待，直到有 “订阅者” 之后才发布事件，所以对于 Cold Observable 的订阅者，它可以保证从一开始看到整个操作的全部过程）。

3 若当前命令的请求缓存功能是被启用的， 并且该命令缓存命中， 那么缓存的结果会立即以 Observable 对象的形式 返回。

4 检查断路器是否为打开状态。如果断路器是打开的，那么Hystrix不会执行命令，而是转接到 fallback 处理逻辑（第 8 步）；如果断路器是关闭的，检查是否有可用资源来执行命令（第 5 步）。

5 线程池/请求队列/信号量是否占满。如果命令依赖服务的专有线程池和请求队列，或者信号量（不使用线程池的时候）已经被占满， 那么 Hystrix 也不会执行命令， 而是转接到 fallback 处理逻辑（第8步）。

6 Hystrix 会根据我们编写的方法来决定采取什么样的方式去请求依赖服务。HystrixCommand.run() ：返回一个单一的结果，或者抛出异常。HystrixObservableCommand.construct()： 返回一个Observable 对象来发射多个结果，或通过 onError 发送错误通知。

7 Hystrix会将 “成功”、“失败”、“拒绝”、“超时” 等信息报告给断路器， 而断路器会维护一组计数器来统计这些数据。断路器会使用这些统计数据来决定是否要将断路器打开，来对某个依赖服务的请求进行 “熔断/短路”。

8 当命令执行失败的时候， Hystrix 会进入 fallback 尝试回退处理， 我们通常也称该操作为 “服务降级”。而能够引起服务降级处理的情况有下面几种：第4步： 当前命令处于"熔断/短路"状态，断路器是打开的时候。第5步： 当前命令的线程池、 请求队列或 者信号量被占满的时候。第6步：HystrixObservableCommand.construct() 或 HystrixCommand.run() 抛出异常的时候。

9 当Hystrix命令执行成功之后， 它会将处理结果直接返回或是以Observable 的形式返回。

Tips：如果我们没有为命令实现降级逻辑或者在降级处理逻辑中抛出了异常， Hystrix 依然会返回一个 Observable 对象， 但是它不会发射任何结果数据， 而是通过 onError 方法通知命令立即中断请求，并通过onError()方法将引起命令失败的异常发送给调用者。