冷飯新炒：理解斷路器CircuitBreaker的原理與實現
阿新 • • 發佈：2020-10-31
## 前提
筆者之前在查詢[Sentinel](https://github.com/alibaba/Sentinel)相關資料的時候，偶然中找到了`Martin Fowler`大神的一篇文章[《CircuitBreaker》](https://martinfowler.com/bliki/CircuitBreaker.html)。於是花了點時間仔細閱讀，順便溫習一下斷路器`CircuitBreaker`的原理與實現。
## CircuitBreaker的原理
現實生活中的熔斷器（更多時候被稱為**保險絲**）是一種安裝在電路中用於保證電路安全執行的電子元件。它的外形一般是一個絕緣的玻璃容器包裹著一段固定大小電阻和固定熔點的纖細合金導體，如下圖：
電路中，保險絲會和其他用電的原件串聯，根據物理公式`Q = I^2*R*T`（`Q`為熱能值，也理解為保險絲熔斷的極限熱能值，`I`為電流中的電流，`R`為保險絲固定電阻，`T`為時間），如果電路中有其他用電的原件短路，會導致電流`I`十分大，導致在`T`很小的情況下，計算得到的`Q`遠大於保險絲熔斷的極限熱能值，保險絲就會被擊穿熔斷。這個時候整個電路處於斷開狀態，從而避免電路過載導致電路中的用電原件損毀。
電路中的電流過大會導致所有電阻比較大的電器發生大量積熱，很容易出現火災，所以保險絲在過去曾經起到巨大的作用。後來出現了更加先進的"空氣開關"，漏電開關多數都升級為此實現，保險絲依然會應用在各種的原件中，但是幾乎淡出了日常生活觸及的視線範圍。
> 記得小時候某個傍晚爺爺拉開了白熾燈，啪的一聲整個屋子的電器都停了，突然停電了。他說了句：保險絲"燒"了，等我換一條。換上保險絲把總閘門打上去後供電恢復。
從上面的分析可見：**現實中的熔斷器是一次性使用的消耗品**，而且有些場景下需要人為干預（更換）。
軟體系統中的`CircuitBreaker`在設計上是借鑑了現實生活中熔斷器的功能並且做出改良而誕生的一種模式。這個模式出現的背景是：隨著軟體和計算機網路的發展，以及當前**微服務架構的普及**，應用會部署在不同的計算機上或者同一臺計算機的不同程序上，那麼需要通過遠端呼叫進行互動。遠端呼叫和單程序的記憶體態呼叫的最大區別之一是：遠端呼叫有可能因為各種原因出現呼叫失敗、沒有響應的掛起（其實就是無超時期限的等待）或者直到某個超時的期限才返回結果。這些故障會導致呼叫方的資源被一直佔用無法釋放（最常見的就是呼叫方接收請求或者處理請求的執行緒被長時間掛起）：
如果發生故障的被呼叫方節點剛好是關鍵節點，並且此故障節點的上游呼叫者比較多（例如上圖中的內部閘道器），那麼級聯故障會蔓延，極端情況下甚至會耗盡了整個服務叢集中的所有資源。如果在服務的遠端呼叫加入了`CircuitBreaker`元件，那麼單個服務呼叫的效果如下：
斷路器`CircuitBreaker`的基本原理比較簡單：將受保護的函式（方法）包裝在斷路器物件中進行呼叫，斷路器物件將會監視所有的呼叫相關的資料（主要是統計維度的資料，一般方法引數可以過濾）。一旦出現故障的呼叫達到了某個閾值或者觸發了某些規則，斷路器就會切換為`Open`狀態，所有經由斷路器的呼叫都會快速失敗，請求不會到達下游被呼叫方。筆者認為從實際來看，`CircuitBreaker`的核心功能就是三大塊：
- 呼叫資料度量統計。
- 維護斷路器自身的狀態。
- 基於前兩點保護包裹在斷路器中執行的呼叫。
基於呼叫資料的度量統計一般會引入`JDK8`中的原子（`Atomic`）型別。下游被呼叫方不會一直處於故障，為了斷路器能夠自恢復，引入了`Half_Open`狀態和滑動視窗的概念。同時，考慮到程式容器的執行緒阻塞帶來的毀滅性影響，有時候可以考慮進行如下優化：斷路器把受保護的呼叫基於定義好的資源標識選擇特定的執行緒池（或者訊號量）進行呼叫，充分利用`FutureTask#get(long timeout, TimeUnit unit)`設定呼叫任務最大超時期限的優勢，這樣就能基本避免出現故障的遠端呼叫阻塞了本應用容器的執行緒。
> 這裡的容器是特指Tomcat、Netty、Jetty等。而這裡提到的執行緒池隔離、滑動視窗等概念會在下文具體實現的時候再詳細展開。
基於執行緒池隔離：
直接基於容器執行緒隔離：
## CircuitBreaker的簡易實現
這一小節會按照上一小節的理論，設計多種`CircuitBreaker`的實現，由簡單到複雜一步一步進行迭代。`CircuitBreaker`的狀態轉換設計圖如下：
基於此設計圖，`Martin Fowler`大神在其文章中也給予了虛擬碼如下：
```shell
class ResetCircuitBreaker...
// 初始化
def initialize &block
@circuit = block
@invocation_timeout = 0.01
@failure_threshold = 5
@monitor = BreakerMonitor.new
@reset_timeout = 0.1
reset
end
// 重置
def reset
@failure_count = 0
@last_failure_time = nil
@monitor.alert :reset_circuit
end
// 狀態維護
def state
case
when (@failure_count >= @failure_threshold) &&
(Time.now - @last_failure_time) > @reset_timeout
:half_open
when (@failure_count >= @failure_threshold)
:open
else
:closed
end
end
// 呼叫
def call args
case state
when :closed, :half_open
begin
do_call args
// 這裡從描述來看應該是漏了呼叫reset方法
// reset
rescue Timeout::Error
record_failure
raise $!
end
when :open
raise CircuitBreaker::Open
else
raise "Unreachable"
end
end
// 記錄失敗
def record_failure
@failure_count += 1
@last_failure_time = Time.now
@monitor.alert(:open_circuit) if :open == state
end
```
下面的多種實現的思路都是基於此虛擬碼的基本框架進行編寫。
### 基於異常閾值不會自恢復的實現
這種實現最簡單，也就是隻需要維護狀態`Closed`轉向`Open`的臨界條件即可，可以設定一個異常計數的閾值，然後使用一個原子計數器統計異常數量即可，`Java`程式碼實現如下：
```java
// 斷路器狀態
public enum CircuitBreakerStatus {
/**
* 關閉
*/
CLOSED,
/**
* 開啟
*/
OPEN,
/**
* 半開啟
*/
HALF_OPEN
}
@Getter
public class SimpleCircuitBreaker {
private final long failureThreshold;
private final LongAdder failureCounter;
private final LongAdder callCounter;
private CircuitBreakerStatus status;
public SimpleCircuitBreaker(long failureThreshold) {
this.failureThreshold = failureThreshold;
this.callCounter = new LongAdder();
this.failureCounter = new LongAdder();
this.status = CircuitBreakerStatus.CLOSED;
}
private final Object fallback = null;
@SuppressWarnings("unchecked")
public T call(Supplier supplier) {
try {
if (CircuitBreakerStatus.CLOSED == this.status) {
return supplier.get();
}
} catch (Exception e) {
this.failureCounter.increment();
tryChangingStatus();
} finally {
this.callCounter.increment();
}
return (T) fallback;
}
private void tryChangingStatus() {
if (this.failureThreshold <= this.failureCounter.sum()) {
this.status = CircuitBreakerStatus.OPEN;
System.out.println(String.format("SimpleCircuitBreaker狀態轉換,[%s]->[%s]", CircuitBreakerStatus.CLOSED,
CircuitBreakerStatus.OPEN));
}
}
public void call(Runnable runnable) {
call(() -> {
runnable.run();
return null;
});
}
}
```
在多執行緒呼叫的前提下，如果在很短時間內有大量的執行緒中的方法調用出現異常，有可能所有呼叫都會湧進去`tryChangingStatus()`方法，這種情況下會導致`CircuitBreaker`的狀態被併發修改，可以考慮使用`AtomicReference`包裹`CircuitBreakerStatus`，做`CAS`更新（確保只更新一次）即可。變更的程式碼如下：
```java
private final AtomicReference status;
public SimpleCircuitBreaker(long failureThreshold) {
......
this.status = new AtomicReference<>(CircuitBreakerStatus.CLOSED);
}
public T call(Supplier supplier) {
try {
if (CircuitBreakerStatus.CLOSED == this.status.get()) {
return supplier.get();
}
......
private void tryChangingStatus() {
if (this.failureThreshold <= this.failureCounter.sum()) {
boolean b = this.status.compareAndSet(CircuitBreakerStatus.CLOSED, CircuitBreakerStatus.OPEN);
if (b) {
System.out.println(String.format("SimpleCircuitBreaker狀態轉換,[%s]->[%s]", CircuitBreakerStatus.CLOSED,
CircuitBreakerStatus.OPEN));
}
}
}
```
併發極高的場景下假設出現呼叫異常前提下，異常計數器`failureCounter`的計數值有可能在一瞬間就遠超過了異常閾值`failureCounter`，但是一般不考慮對這些計數值的比較或者狀態切換的準確時機新增同步機制（例如加鎖），因為一旦加入同步機制會大大降低併發效能，這樣引入斷路器反而成為了效能隱患，顯然是不合理的。所以一般設計斷路器邏輯的時候，並不需要控制斷路器狀態切換的具體計數值臨界點，保證狀態一定切換正常即可。基於此簡陋斷路器編寫一個同步呼叫的測試例子：
```java
public static class Service {
public String process(int i) {
System.out.println("進入process方法,number:" + i);
throw new RuntimeException(String.valueOf(i));
}
}
public static void main(String[] args) throws Exception {
SimpleCircuitBreaker circuitBreaker = new SimpleCircuitBreaker(5L);
Service service = new Service();
for (int i = 0; i < 10; i++) {
int temp = i;
String result = circuitBreaker.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
}
```
測試結果輸出如下：
```shell
進入process方法,number:0
返回結果:null,number:0
進入process方法,number:1
返回結果:null,number:1
進入process方法,number:2
返回結果:null,number:2
進入process方法,number:3
返回結果:null,number:3
進入process方法,number:4
SimpleCircuitBreaker狀態轉換,[CLOSED]->[OPEN]
返回結果:null,number:4
返回結果:null,number:5
返回結果:null,number:6
返回結果:null,number:7
返回結果:null,number:8
返回結果:null,number:9
```
> 細心的夥伴會發現，基本上狀態的維護和變更和資料統計都位於呼叫異常或者失敗的方法入口以及最後的finally程式碼塊，在真實的呼叫邏輯前一般只會做狀態判斷或者下文提到的分配呼叫資源等。
### 基於異常閾值並且能夠自恢復的實現
基於異常閾值、能夠自恢復的`CircuitBreaker`實現需要引入`Half_Open`狀態，同時需要記錄最後一次失敗呼叫的時間戳以及`reset_timeout`（斷路器的當前的系統時間戳減去上一階段最後一次失敗呼叫的時間差，大於某個值的時候，並且當前的失敗呼叫大於失敗閾值則需要把狀態重置為`Half_Open`，這裡的"某個值"定義為`reset_timeout`），示意圖如下：
假設當前的呼叫為圓形`6`，當前系統時間戳減去（上一輪）最後一個失敗呼叫（圓形`5`）的時間戳大於預設的`reset_timeout`的時候，不論當次呼叫是成功還是失敗，直到下一次呼叫失敗或者失敗呼叫數降低到轉換為`Closed`狀態之前，都處於`Half_Open`狀態，會對單個呼叫進行放行（併發場景下也有可能同時放行多個呼叫）。程式碼實現如下：
```java
// 新增一個Monitor用於記錄狀態變更
public enum CircuitBreakerStatusMonitor {
/**
* 單例
*/
X;
public void report(String name, CircuitBreakerStatus o, CircuitBreakerStatus n) {
System.out.println(String.format("斷路器[%s]狀態變更,[%s]->[%s]", name, o, n));
}
public void reset(String name) {
System.out.println(String.format("斷路器[%s]重置", name));
}
}
@Getter
public class RestCircuitBreaker {
private final long failureThreshold;
private final long resetTimeout;
private LongAdder failureCounter;
private LongAdder callCounter;
private AtomicReference status;
private final Object fallback = null;
/**
* 最後一次呼叫失敗的時間戳
*/
private long lastFailureTime;
public RestCircuitBreaker(long failureThreshold, long resetTimeout) {
this.failureThreshold = failureThreshold;
this.resetTimeout = resetTimeout;
reset();
}
public void reset() {
CircuitBreakerStatusMonitor.X.reset("RestCircuitBreaker");
this.callCounter = new LongAdder();
this.failureCounter = new LongAdder();
this.status = new AtomicReference<>(CircuitBreakerStatus.CLOSED);
this.lastFailureTime = -1L;
}
@SuppressWarnings("unchecked")
public T call(Supplier supplier) {
try {
if (shouldAllowExecution()) {
T result = supplier.get();
markSuccess();
return result;
}
} catch (Exception e) {
markNoneSuccess();
} finally {
this.callCounter.increment();
}
return (T) fallback;
}
public void call(Runnable runnable) {
call(() -> {
runnable.run();
return null;
});
}
boolean shouldAllowExecution() {
// 本質是Closed狀態
if (lastFailureTime == -1L) {
return true;
}
// 沒到達閾值
if (failureThreshold > failureCounter.sum()) {
return true;
}
return shouldTryAfterRestTimeoutWindow()
&& changeStatus(CircuitBreakerStatus.OPEN, CircuitBreakerStatus.HALF_OPEN);
}
boolean changeStatus(CircuitBreakerStatus o, CircuitBreakerStatus n) {
boolean r = status.compareAndSet(o, n);
if (r) {
CircuitBreakerStatusMonitor.X.report("RestCircuitBreaker", o, n);
}
return r;
}
boolean shouldTryAfterRestTimeoutWindow() {
long lastFailureTimeSnap = lastFailureTime;
long currentTime = System.currentTimeMillis();
return currentTime > lastFailureTimeSnap + resetTimeout;
}
public void markSuccess() {
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.CLOSED)) {
reset();
}
}
public void markNoneSuccess() {
this.failureCounter.increment();
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
if (this.failureCounter.sum() >= failureThreshold &&
changeStatus(CircuitBreakerStatus.CLOSED, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
}
}
```
編寫一個測試客戶端`RestCircuitBreakerClient`：
```java
public class RestCircuitBreakerClient {
public static void main(String[] args) throws Exception {
Service service = new Service();
RestCircuitBreaker cb = new RestCircuitBreaker(5, 500);
for (int i = 0; i < 10; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
Thread.sleep(501L);
// 故意成功
cb.call(service::processSuccess);
for (int i = 0; i < 3; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
}
public static class Service {
public String process(int i) {
System.out.println("進入process方法,number:" + i);
throw new RuntimeException(String.valueOf(i));
}
public void processSuccess() {
System.out.println("呼叫processSuccess方法");
}
}
}
```
輸出結果如下：
```shell
斷路器[RestCircuitBreaker]重置
進入process方法,number:0
返回結果:null,number:0
進入process方法,number:1
返回結果:null,number:1
進入process方法,number:2
返回結果:null,number:2
進入process方法,number:3
返回結果:null,number:3
進入process方法,number:4
斷路器[RestCircuitBreaker]狀態變更,[CLOSED]->[OPEN]
返回結果:null,number:4
返回結果:null,number:5
返回結果:null,number:6
返回結果:null,number:7
返回結果:null,number:8
返回結果:null,number:9
斷路器[RestCircuitBreaker]狀態變更,[OPEN]->[HALF_OPEN]
呼叫processSuccess方法 # <------ 這個位置的成功呼叫重置了斷路器的狀態
斷路器[RestCircuitBreaker]狀態變更,[HALF_OPEN]->[CLOSED]
斷路器[RestCircuitBreaker]重置
進入process方法,number:0
返回結果:null,number:0
進入process方法,number:1
返回結果:null,number:1
進入process方法,number:2
返回結果:null,number:2
```
### 基於執行緒池隔離和超時控制
在使用`CircuitBreaker`的時候，可以基於不同的資源（唯一標識可以使用`resource_key`或者`resource_name`）建立單獨的執行緒池，讓資源基於執行緒池進行隔離呼叫。這種設計的原則借鑑於運貨船的船艙設計，每個船艙都使用絕緣的材料進行分隔，一旦某個船艙出現了火情，也不會蔓延到其他船艙。在`Java`體系中，可以使用執行緒池`ThreadPoolExecutor#submit(Callable task)`進行指定超時上限限制的任務提交和結果獲取，這樣就可以預設一個呼叫超時時間上限，限制每個呼叫的可用的最大呼叫時間。
首先需要設計一個輕量級的資源執行緒池管理模組：
```java
// 資源配置
@Data
public class CircuitBreakerResourceConf {
private String resourceName;
private int coreSize;
private int queueSize;
private long timeout;
}
public enum CircuitBreakerResourceManager {
/**
* 單例
*/
X;
public final Map cache = new ConcurrentHashMap<>(8);
public void register(CircuitBreakerResourceConf conf) {
cache.computeIfAbsent(conf.getResourceName(), rn -> {
int coreSize = conf.getCoreSize();
int queueSize = conf.getQueueSize();
BlockingQueue queue;
if (queueSize > 0) {
queue = new ArrayBlockingQueue<>(queueSize);
} else {
queue = new SynchronousQueue<>();
}
ThreadPoolExecutor executor = new ThreadPoolExecutor(
coreSize,
coreSize,
0,
TimeUnit.SECONDS,
queue,
new ThreadFactory() {
private final AtomicInteger counter = new AtomicInteger();
@Override
public Thread newThread(Runnable r) {
Thread thread = new Thread(r);
thread.setDaemon(true);
thread.setName(rn + "-CircuitBreakerWorker-" + counter.getAndIncrement());
return thread;
}
},
new ThreadPoolExecutor.AbortPolicy()
);
CircuitBreakerResource resource = new CircuitBreakerResource();
resource.setExecutor(executor);
resource.setTimeout(conf.getTimeout());
return resource;
});
}
public CircuitBreakerResource get(String resourceName) {
return Optional.ofNullable(cache.get(resourceName)).orElseThrow(() -> new IllegalArgumentException(resourceName));
}
}
```
編寫斷路器`ResourceCircuitBreaker`的實現程式碼：
```java
@Getter
public class ResourceCircuitBreaker {
private final long failureThreshold;
private final long resetTimeout;
private LongAdder failureCounter;
private LongAdder callCounter;
private AtomicReference status;
private final ThreadPoolExecutor executor;
private final Object fallback = null;
private final String circuitBreakerName;
/**
* 最後一次呼叫失敗的時間戳
*/
private long lastFailureTime;
/**
* 執行超時上限,單位毫秒
*/
private final long executionTimeout;
public ResourceCircuitBreaker(String resourceName, long failureThreshold, long resetTimeout) {
CircuitBreakerResource resource = CircuitBreakerResourceManager.X.get(resourceName);
this.circuitBreakerName = "ResourceCircuitBreaker-" + resourceName;
this.executor = resource.getExecutor();
this.executionTimeout = resource.getTimeout();
this.failureThreshold = failureThreshold;
this.resetTimeout = resetTimeout;
reset();
}
public void reset() {
CircuitBreakerStatusMonitor.X.reset(this.circuitBreakerName);
this.callCounter = new LongAdder();
this.failureCounter = new LongAdder();
this.status = new AtomicReference<>(CircuitBreakerStatus.CLOSED);
this.lastFailureTime = -1L;
}
@SuppressWarnings("unchecked")
public T call(Supplier supplier) {
try {
if (shouldAllowExecution()) {
Future future = this.executor.submit(warp(supplier));
T result = future.get(executionTimeout, TimeUnit.MILLISECONDS);
markSuccess();
return result;
}
} catch (Exception e) {
markNoneSuccess();
} finally {
this.callCounter.increment();
}
return (T) fallback;
}
Callable warp(Supplier supplier) {
return supplier::get;
}
public void call(Runnable runnable) {
call(() -> {
runnable.run();
return null;
});
}
boolean shouldAllowExecution() {
// 本質是Closed狀態
if (lastFailureTime == -1L) {
return true;
}
// 沒到達閾值
if (failureThreshold > failureCounter.sum()) {
return true;
}
return shouldTryAfterRestTimeoutWindow()
&& changeStatus(CircuitBreakerStatus.OPEN, CircuitBreakerStatus.HALF_OPEN);
}
boolean changeStatus(CircuitBreakerStatus o, CircuitBreakerStatus n) {
boolean r = status.compareAndSet(o, n);
if (r) {
CircuitBreakerStatusMonitor.X.report(this.circuitBreakerName, o, n);
}
return r;
}
boolean shouldTryAfterRestTimeoutWindow() {
long lastFailureTimeSnap = lastFailureTime;
long currentTime = System.currentTimeMillis();
return currentTime > lastFailureTimeSnap + resetTimeout;
}
public void markSuccess() {
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.CLOSED)) {
reset();
}
}
public void markNoneSuccess() {
this.failureCounter.increment();
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
if (this.failureCounter.sum() >= failureThreshold &&
changeStatus(CircuitBreakerStatus.CLOSED, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
}
}
```
編寫測試場景類`ResourceCircuitBreakerClient`：
```java
public class ResourceCircuitBreakerClient {
public static void main(String[] args) throws Exception {
CircuitBreakerResourceConf conf = new CircuitBreakerResourceConf();
conf.setCoreSize(10);
conf.setQueueSize(0);
conf.setResourceName("SERVICE");
conf.setTimeout(50);
CircuitBreakerResourceManager.X.register(conf);
Service service = new Service();
ResourceCircuitBreaker cb = new ResourceCircuitBreaker("SERVICE", 5, 500);
for (int i = 0; i < 10; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
Thread.sleep(501L);
cb.call(service::processSuccess);
for (int i = 0; i < 3; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
}
public static class Service {
private final Random r = new Random();
public String process(int i) {
int sleep = r.nextInt(200);
System.out.println(String.format("執行緒[%s]-進入process方法,number:%d,休眠%d毫秒",
Thread.currentThread().getName(), i, sleep));
try {
Thread.sleep(sleep);
} catch (InterruptedException ignore) {
}
return String.valueOf(i);
}
public void processSuccess() {
System.out.println(String.format("執行緒[%s]-呼叫processSuccess方法", Thread.currentThread().getName()));
}
}
}
```
某次執行的輸出結果如下：
```shell
斷路器[ResourceCircuitBreaker-SERVICE]重置
執行緒[SERVICE-CircuitBreakerWorker-0]-進入process方法,number:0,休眠67毫秒
返回結果:null,number:0
執行緒[SERVICE-CircuitBreakerWorker-1]-進入process方法,number:1,休眠85毫秒
返回結果:null,number:1
執行緒[SERVICE-CircuitBreakerWorker-2]-進入process方法,number:2,休眠72毫秒
返回結果:null,number:2
執行緒[SERVICE-CircuitBreakerWorker-3]-進入process方法,number:3,休眠88毫秒
返回結果:null,number:3
執行緒[SERVICE-CircuitBreakerWorker-4]-進入process方法,number:4,休眠28毫秒
返回結果:4,number:4
執行緒[SERVICE-CircuitBreakerWorker-5]-進入process方法,number:5,休眠102毫秒
斷路器[ResourceCircuitBreaker-SERVICE]狀態變更,[CLOSED]->[OPEN]
返回結果:null,number:5
返回結果:null,number:6
返回結果:null,number:7
返回結果:null,number:8
返回結果:null,number:9
斷路器[ResourceCircuitBreaker-SERVICE]狀態變更,[OPEN]->[HALF_OPEN]
執行緒[SERVICE-CircuitBreakerWorker-6]-呼叫processSuccess方法
斷路器[ResourceCircuitBreaker-SERVICE]狀態變更,[HALF_OPEN]->[CLOSED]
斷路器[ResourceCircuitBreaker-SERVICE]重置
執行緒[SERVICE-CircuitBreakerWorker-7]-進入process方法,number:0,休眠74毫秒
返回結果:null,number:0
執行緒[SERVICE-CircuitBreakerWorker-8]-進入process方法,number:1,休眠111毫秒
返回結果:null,number:1
執行緒[SERVICE-CircuitBreakerWorker-9]-進入process方法,number:2,休眠183毫秒
返回結果:null,number:2
```
### 滑動視窗和百分比統計
上一個小節已經實現了資源基於執行緒池隔離進行呼叫，但是有一點明顯的不足就是：斷路器的狀態管理和重置並不符合生產場景，`HALF_OPEN -> CLOSED`的狀態切換和重置不應該在放行單個呼叫成功之後立刻觸發，而應該建立在一定時間範圍內，呼叫的（平均）失敗率下降到某個閾值或者呼叫的（平均）成功率恢復到某個閾值，否則很多場景下會導致斷路器的狀態頻繁發生切換，功能基本處於失效的狀態。也就是大多數場景下，一段時間內的`failurePercent`會比異常計數和`failureThreshold`的直接對比更加準確。可以引入滑動視窗（`Sliding Window`）的概念，記錄每個時間單元內的呼叫總次數、呼叫成功次數、呼叫超時次數和非超時的呼叫失敗次數，為了簡化操作這個時間單元定義為`1`秒：
定義一個用於記錄這四種呼叫次數的桶`Bucket`類（這裡的實現稍微跟上圖有點不同，非超時失敗修改為執行緒池拒絕的任務統計，而失敗統計包括了任務超時執行和一般的業務異常）：
```java
@RequiredArgsConstructor
@Getter
public class MetricInfo {
private final long total;
private final long success;
private final long failure;
private final long reject;
public static final MetricInfo EMPTY = new MetricInfo(0, 0, 0, 0);
public MetricInfo merge(MetricInfo other) {
return new MetricInfo(
this.total + other.getTotal(),
this.success + other.getSuccess(),
this.failure + other.getFailure(),
this.reject + other.getReject()
);
}
}
public class Bucket {
// 記錄視窗開始的時間戳
@Getter
private final long windowStartTimestamp;
private final LongAdder total;
private final LongAdder success;
private final LongAdder failure;
private final LongAdder reject;
public Bucket(long windowStartTimestamp) {
this.windowStartTimestamp = windowStartTimestamp;
this.total = new LongAdder();
this.success = new LongAdder();
this.reject = new LongAdder();
this.failure = new LongAdder();
}
public void increaseTotal() {
this.total.increment();
}
public void increaseSuccess() {
this.success.increment();
}
public void increaseFailure() {
this.failure.increment();
}
public void increaseReject() {
this.reject.increment();
}
public long totalCount() {
return this.total.sum();
}
public long successCount() {
return this.success.sum();
}
public long failureCount() {
return this.failure.sum();
}
public long rejectCount() {
return this.reject.sum();
}
public void reset() {
this.total.reset();
this.success.reset();
this.failure.reset();
this.reject.reset();
}
public MetricInfo metricInfo() {
return new MetricInfo(
totalCount(),
successCount(),
failureCount(),
rejectCount()
);
}
@Override
public String toString() {
return String.format("Bucket[wt=%d,t=%d,s=%d,f=%d,r=%d]",
windowStartTimestamp,
totalCount(),
successCount(),
failureCount(),
rejectCount()
);
}
}
```
在`Hystrix`中，為了更加靈活，`Bucket`中的計數器設計為`LongAdder[]`型別，便於通過各種需要計數事件列舉的順序值來直接進行計數和累加，而為了節約記憶體空間，滑動視窗設計成一個容量固定可複用的環形佇列`BucketCircularArray#ListState`，這裡可以站在巨人的肩膀上借鑑其思路實現`BucketCircular`：
```java
public class BucketCircular implements Iterable {
private final AtomicReference bucketArray;
public BucketCircular(int bucketNumber) {
// 這裡有個技巧,初始化陣列的時候讓陣列的總長度為桶數量+1,便於額外的新增和移除桶操作
AtomicReferenceArray buckets = new AtomicReferenceArray<>(bucketNumber + 1);
this.bucketArray = new AtomicReference<>(new BucketArray(buckets, 0, 0, bucketNumber));
}
public Bucket getTail() {
return this.bucketArray.get().tail();
}
/**
* 在環形佇列尾部新增一個桶
*/
public void addTail(Bucket bucket) {
BucketArray bucketArray = this.bucketArray.get();
BucketArray newBucketArray = bucketArray.addBucket(bucket);
// 這個方法會在鎖中執行,理論上不會CAS失敗
this.bucketArray.compareAndSet(bucketArray, newBucketArray);
}
public Bucket[] toArray() {
return this.bucketArray.get().toArray();
}
public int size() {
return this.bucketArray.get().getSize();
}
@Override
public Iterator iterator() {
return Collections.unmodifiableList(Arrays.asList(toArray())).iterator();
}
public void clear() {
while (true) {
BucketArray bucketArray = this.bucketArray.get();
BucketArray clear = bucketArray.clear();
if (this.bucketArray.compareAndSet(bucketArray, clear)) {
return;
}
}
}
}
```
新增一個新的`Bucket`到迴圈佇列的尾部的時候，因為佇列的長度是固定的，需要判斷是否需要重新計算頭指標和尾指標。測試一下：
```java
public static void main(String[] args) throws Exception {
BucketCircular circular = new BucketCircular(5);
circular.addTail(new Bucket(111L));
circular.addTail(new Bucket(System.currentTimeMillis()));
circular.addTail(new Bucket(System.currentTimeMillis()));
circular.addTail(new Bucket(System.currentTimeMillis()));
circular.addTail(new Bucket(System.currentTimeMillis()));
circular.addTail(new Bucket(System.currentTimeMillis()));
circular.addTail(new Bucket(222L));
Stream.of(circular.toArray()).forEach(System.out::println);
}
// 輸出結果
Bucket[wt=1603613365205,t=0,s=0,f=0,r=0]
Bucket[wt=1603613365205,t=0,s=0,f=0,r=0]
Bucket[wt=1603613365205,t=0,s=0,f=0,r=0]
Bucket[wt=1603613365205,t=0,s=0,f=0,r=0]
Bucket[wt=222,t=0,s=0,f=0,r=0]
```
接著編寫一個用於管理`Bucket`和提供資料統計入口的`SlidingWindowMonitor`：
```java
// 累計資料累加器
public class BucketCumulativeCalculator {
private LongAdder total = new LongAdder();
private LongAdder success = new LongAdder();
private LongAdder failure = new LongAdder();
private LongAdder reject = new LongAdder();
public void addBucket(Bucket lb) {
total.add(lb.totalCount());
success.add(lb.successCount());
failure.add(lb.failureCount());
reject.add(lb.rejectCount());
}
public MetricInfo sum() {
return new MetricInfo(
total.sum(),
success.sum(),
failure.sum(),
reject.sum()
);
}
public void reset() {
total = new LongAdder();
success = new LongAdder();
failure = new LongAdder();
reject = new LongAdder();
}
}
// 下面的幾個引數為了簡單起見暫時固定
public class SlidingWindowMonitor {
/**
* 視窗長度 - 10秒
*/
private final int windowDuration = 10000;
/**
* 桶的大小 - 時間單位為1秒
*/
private final int bucketSizeInTimeUint = 1000;
/**
* 桶的數量 - 必須滿足windowDuration % bucketSizeInTimeUint = 0
*/
private final int bucketNumber = windowDuration / bucketSizeInTimeUint;
private final BucketCircular bucketCircular;
/**
* 用於建立桶的時候進行鎖定
*/
private final ReentrantLock lock;
/**
* 累計計數器
*/
private final BucketCumulativeCalculator calculator = new BucketCumulativeCalculator();
public SlidingWindowMonitor() {
this.bucketCircular = new BucketCircular(bucketNumber);
this.lock = new ReentrantLock();
}
void reset() {
Bucket tailBucket = bucketCircular.getTail();
if (null != tailBucket) {
calculator.addBucket(tailBucket);
}
bucketCircular.clear();
}
/**
* 累計統計
*/
public MetricInfo getCumulativeMetricInfo() {
return getCurrentMetricInfo().merge(calculator.sum());
}
/**
* 當前統計
*/
public MetricInfo getCurrentMetricInfo() {
Bucket currentBucket = getCurrentBucket();
if (null == currentBucket) {
return MetricInfo.EMPTY;
}
return currentBucket.metricInfo();
}
/**
* 滾動統計 - 這個就是斷路器計算錯誤請求百分比的來源資料
*/
public MetricInfo getRollingMetricInfo() {
Bucket currentBucket = getCurrentBucket();
if (null == currentBucket) {
return MetricInfo.EMPTY;
}
MetricInfo info = new MetricInfo(0, 0, 0, 0);
for (Bucket bucket : this.bucketCircular) {
info = info.merge(bucket.metricInfo());
}
return info;
}
/**
* 這個方法是核心 - 用於獲取當前系統時間對應的Bucket
*/
Bucket getCurrentBucket() {
long time = System.currentTimeMillis();
Bucket tailBucket = bucketCircular.getTail();
// 隊尾的桶還在當前的時間所在的桶區間內則直接使用此桶
if (null != tailBucket && time < tailBucket.getWindowStartTimestamp() + bucketSizeInTimeUint) {
return tailBucket;
}
if (lock.tryLock()) {
try {
// 迴圈佇列為空
if (null == bucketCircular.getTail()) {
Bucket newBucket = new Bucket(time);
bucketCircular.addTail(newBucket);
return newBucket;
} else {
// 需要建立足夠多的桶以追上當前的時間
for (int i = 0; i < bucketNumber; i++) {
tailBucket = bucketCircular.getTail();
// 最新的一個桶已經追上了當前時間
if (time < tailBucket.getWindowStartTimestamp() + bucketSizeInTimeUint) {
return tailBucket;
}
// 當前時間已經到了下一個視窗
else if (time > status;
private final ThreadPoolExecutor executor;
private final String circuitBreakerName;
/**
* 最後一次呼叫失敗的時間戳
*/
private long lastFailureTime;
/**
* 執行超時上限,單位毫秒
*/
private final long executionTimeout;
/**
* 滑動視窗監視器
*/
private final SlidingWindowMonitor slidingWindowMonitor;
public SlidingWindowCircuitBreaker(String resourceName,
long errorPercentThreshold,
long resetTimeout) {
CircuitBreakerResource resource = CircuitBreakerResourceManager.X.get(resourceName);
this.circuitBreakerName = "SlidingWindowCircuitBreaker-" + resourceName;
this.executor = resource.getExecutor();
this.executionTimeout = resource.getTimeout();
this.errorPercentThreshold = errorPercentThreshold;
this.resetTimeout = resetTimeout;
this.slidingWindowMonitor = new SlidingWindowMonitor();
reset();
}
public void reset() {
CircuitBreakerStatusMonitor.X.reset(this.circuitBreakerName);
this.status = new AtomicReference<>(CircuitBreakerStatus.CLOSED);
this.lastFailureTime = -1L;
}
@SuppressWarnings("unchecked")
public T call(Supplier supplier) {
return call(supplier, (Fallback) Fallback.F);
}
public T call(Supplier supplier, Fallback fallback) {
try {
if (shouldAllowExecution()) {
slidingWindowMonitor.incrementTotal();
Future future = this.executor.submit(warp(supplier));
T result = future.get(executionTimeout, TimeUnit.MILLISECONDS);
markSuccess();
return result;
}
} catch (RejectedExecutionException ree) {
markReject();
} catch (Exception e) {
markFailure();
}
return fallback.fallback();
}
Callable warp(Supplier supplier) {
return supplier::get;
}
public void call(Runnable runnable) {
call(() -> {
runnable.run();
return null;
});
}
boolean shouldAllowExecution() {
// 本質是Closed狀態
if (lastFailureTime == -1L) {
return true;
}
// 沒到達閾值
if (errorPercentThreshold > rollingErrorPercentage()) {
return false;
}
return shouldTryAfterRestTimeoutWindow()
&& changeStatus(CircuitBreakerStatus.OPEN, CircuitBreakerStatus.HALF_OPEN);
}
boolean changeStatus(CircuitBreakerStatus o, CircuitBreakerStatus n) {
boolean r = status.compareAndSet(o, n);
if (r) {
CircuitBreakerStatusMonitor.X.report(this.circuitBreakerName, o, n);
}
return r;
}
boolean shouldTryAfterRestTimeoutWindow() {
long lastFailureTimeSnap = lastFailureTime;
long currentTime = System.currentTimeMillis();
return currentTime > lastFailureTimeSnap + resetTimeout;
}
public void markSuccess() {
slidingWindowMonitor.incrementSuccess();
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.CLOSED)) {
reset();
}
}
public void markReject() {
slidingWindowMonitor.incrementReject();
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
}
public int rollingErrorPercentage() {
MetricInfo rollingMetricInfo = slidingWindowMonitor.getRollingMetricInfo();
long rejectCount = rollingMetricInfo.getReject();
long failureCount = rollingMetricInfo.getFailure();
long totalCount = rollingMetricInfo.getTotal();
int errorPercentage = (int) ((double) (rejectCount + failureCount) / totalCount * 100);
CircuitBreakerStatusMonitor.X.report(this.circuitBreakerName, String.format("錯誤百分比:%d", errorPercentage));
return errorPercentage;
}
public void markFailure() {
slidingWindowMonitor.incrementFailure();
if (changeStatus(CircuitBreakerStatus.HALF_OPEN, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
if (rollingErrorPercentage() >= errorPercentThreshold &&
changeStatus(CircuitBreakerStatus.CLOSED, CircuitBreakerStatus.OPEN)) {
this.lastFailureTime = System.currentTimeMillis();
}
}
}
```
編寫一個測試客戶端`SlidingWindowCircuitBreakerClient`：
```java
public class SlidingWindowCircuitBreakerClient {
public static void main(String[] args) throws Exception {
CircuitBreakerResourceConf conf = new CircuitBreakerResourceConf();
conf.setCoreSize(10);
conf.setQueueSize(0);
conf.setResourceName("SERVICE");
conf.setTimeout(50);
CircuitBreakerResourceManager.X.register(conf);
Service service = new Service();
SlidingWindowCircuitBreaker cb = new SlidingWindowCircuitBreaker("SERVICE", 50, 500);
for (int i = 0; i < 10; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
Thread.sleep(501L);
cb.call(service::processSuccess);
for (int i = 0; i < 3; i++) {
int temp = i;
String result = cb.call(() -> service.process(temp));
System.out.println(String.format("返回結果:%s,number:%d", result, temp));
}
Thread.sleep(501L);
cb.call(service::processSuccess);
cb.call(service::processSuccess);
}
public static class Service {
private final Random r = new Random();
public String process(int i) {
int sleep = r.nextInt(200);
System.out.println(String.format("執行緒[%s]-進入process方法,number:%d,休眠%d毫秒",
Thread.currentThread().getName(), i, sleep));
try {
Thread.sleep(sleep);
} catch (InterruptedException ignore) {
}
return String.valueOf(i);
}
public void processSuccess() {
System.out.println(String.format("執行緒[%s]-呼叫processSuccess方法", Thread.currentThread().getName()));
}
}
}
```
某次執行結果如下：
```shell
斷路器[SlidingWindowCircuitBreaker-SERVICE]重置
執行緒[SERVICE-CircuitBreakerWorker-0]-進入process方法,number:0,休眠67毫秒
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[CLOSED]->[OPEN]
返回結果:null,number:0
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:1
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:2
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:3
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:4
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:5
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:6
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:7
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:8
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
返回結果:null,number:9
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:100
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[OPEN]->[HALF_OPEN]
執行緒[SERVICE-CircuitBreakerWorker-1]-呼叫processSuccess方法
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[HALF_OPEN]->[CLOSED]
斷路器[SlidingWindowCircuitBreaker-SERVICE]重置
執行緒[SERVICE-CircuitBreakerWorker-2]-進入process方法,number:0,休眠84毫秒
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:66
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[CLOSED]->[OPEN]
返回結果:null,number:0
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:66
返回結果:null,number:1
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:66
返回結果:null,number:2
斷路器[SlidingWindowCircuitBreaker-SERVICE]-錯誤百分比:66
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[OPEN]->[HALF_OPEN]
執行緒[SERVICE-CircuitBreakerWorker-3]-呼叫processSuccess方法
斷路器[SlidingWindowCircuitBreaker-SERVICE]狀態變更,[HALF_OPEN]->[CLOSED]
斷路器[SlidingWindowCircuitBreaker-SERVICE]重置
執行緒[SERVICE-CircuitBreakerWorker-4]-呼叫processSuccess方法
```
## 小結
生產上應用`CircuitBreaker`模式建議使用主流實現例如`Hystrix`或者更活躍的`Sentinel`，但是要深入學習此模式則需要老老實實做一次推演。
參考資料：
- [CircuitBreaker](https://martinfowler.com/bliki/CircuitBreaker.html) - by Martin Fowler
- 《Release It! Design and Deploy Production-Ready Software》
（本文完 c-4-d e-a-20201025）
## 個人部落格
- [Throwable's Blog](https://throwx.cn/2020/10/31/learn-about-circuit-