熔断

更新时间：2024-08-20 GMT+08:00

熔断规则借鉴了Resilience4j的思想，作用在服务端，其原理为：

达到指定failureRateThreshold错误率或者slowCallRateThreshold慢请求率时进行熔断，返回响应码429，慢请求通过SlowCallDurationThreshold定义。minimumNumberOfCalls是达到熔断要求的最低请求数量门槛，例如，若minimumNumberOfCalls是10，为计算失败率，则最小要记录10个调用。若只记录了9个调用，即使9个都失败，CircuitBreaker也不会打开。slidingWindowType指定滑动窗口类型，默认可选count/time，分别是基于请求数量窗口和基于时间窗口。若滑动窗口为count，则最近slidingWindowSize次的调用会被记录和统计。若滑动窗口为time，则最近slidingWindowSize秒中的调用会被记录和统计。slidingWindowSize指定窗口大小，根据滑动窗口类型，单位可能是请求数量或者秒。

Java Chassis的熔断作用于微服务消费者，需要微服务应用集成熔断模块，启用bizkeeper-consumer处理链。
配置示例如下：
```
servicecomb:
  handler:
    chain:
      Consumer:
        default: bizkeeper-consumer
```
在POM中添加如下依赖：
```
<dependency>
  <groupId>org.apache.servicecomb</groupId>
  <artifactId>handler-bizkeeper</artifactId>
  <version>${project.version}</version>
</dependency>
```
详细说明请参考流量特征治理。

说明：

此处以微服务开发框架Java Chassis 2.x版本为例介绍。3.x版本配置详情请参考流量特征治理。
Spring Cloud Huawei通过Aspect拦截RequestMappingHandlerAdapter实现了熔断，集成Spring Cloud Huawei以后，默认集成了客户端熔断模块spring-cloud-starter-huawei-governance，只需要通过配置开启具体的客户端熔断策略。
配置示例如下：
```
servicecomb:
  matchGroup:
    AllOperation: |
      matches:
        - apiPath:
            prefix: "/"
  instanceIsolation:     
    AllOperation: |      
      minimumNumberOfCalls: 10      
      slidingWindowSize: 10      
      slidingWindowType: COUNT_BASED      
      failureRateThreshold: 20
      recordFailureStatus:
        - 502
        - 503
```
默认策略是在异常错误码为502、503情况下生效，1.11.4-2021.0.x/1.11.4-2022.0.x版本开始支持响应头header的特殊场景生效。

响应头header设置key默认为"X-HTTP-STATUS-CODE"，也支持自定义设置，只需要在客户端配置如下配置：
```
spring:
  cloud:
    servicecomb:
      governance:
        response:
          header:
            status:
              key: 'X-HTTP-EEROR-STATUS-CODE'
```
同样响应头header中设置的响应码也支持自定义，但是需要在容错策略中增加对应的错误码，例如设置X-HTTP-STATUS-CODE=511，那么错误码中增加511错误码，配置如下：
```
servicecomb:
  matchGroup:
    AllOperation: |
      matches:
        - apiPath:
            prefix: "/"
  instanceIsolation:     
    AllOperation: |      
      minimumNumberOfCalls: 10      
      slidingWindowSize: 10      
      slidingWindowType: COUNT_BASED      
      failureRateThreshold: 20
      recordFailureStatus:
        - 502
        - 503
        - 511
```
上述配置对所有实例启用了客户端熔断策略。该策略采用COUNT_BASED滑动窗口策略，窗口大小为10个请求，到达10个请求的时候，开始计算错误率，如果错误率达到20%，就会对后续请求进行熔断。默认的滑动窗口策略是TIME_BASED。策略执行顺序为优先判断响应码，如果异常响应码满足策略设置，容错开启；响应码不满足后，再判断header设置的响应编码是否满足条件。

父主题： 使用服务治理

上一篇：容错

下一篇：隔离仓

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

熔断

意见反馈

文档内容是否对您有帮助？

文档反馈